Notas de Ajuste Documento Equivalente#
Nota de Ajuste Crédito de Documento Equivalente#
Este documento permite realizar cambios, ajustes y/o correcciones a los documentos equivalentes, tales como generar abonos o créditos a favor del cliente debido a un cobro mayor en la factura de venta inicialmente transmitida. A través de Saphety, en calidad de Proveedor Tecnológico autorizado por la DIAN, se facilita la generación, transmisión para validación, validación y expedición del documento, conforme a los requisitos y definiciones legales del anexo técnico vigente regulado por la DIAN.
A continuación, se describen los métodos y estructuras para la creación de una Nota de Ajuste Tipo Crédito de un Documento Equivalente Electrónico.
Creación de una Nota de Ajuste Crédito de Documento Equivalente (NAC).#
Para consumir la API, es importante tener en cuenta el entorno en el que se va a trabajar. SOVOS Saphety dispone de dos ambientes, los cuales se especifican en el apartado de Entornos.
Consumo del método de creación.#
El Verbo Http (acción) que se utiliza para la creación de este documento es:
POST
El método que se utiliza para la creación de este documento es:
/v2/{virtualOperator}/outbounddocuments/equivalentDocumentAdjustAsync
Parameters
Para esta petición se requiere como parámetro el alias de su operador virtual.
Parametro virtualOperator
Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.
Body#
Estructura del mensaje JSON de una Nota de Ajuste Tipo Crédito de un Documento Equivalente#
A continuación, encontrará la estructura base definida por Saphety para la creación de una Nota de Ajuste Tipo Crédito de un Documento Equivalente Electrónico.
JSON (DTO)
{
"IssueDate": "2024-03-27T15:43:09.958Z",
"Currency": "COP",
"DueDate": "2024-03-27T15:43:09.958Z", //*
"DeliveryDate": "2024-03-27T15:43:09.958Z", //*
"SeriePrefix": "NCDE", //**
"SerieNumber": "2500003", //**
"ReasonCredit": "1",
"OperationType": "20",
"SerieExternalKey": "{{serieexternalkeyNCDE}}", // No tenemos resolucion de pruebas ya que DIAN no ha desplegado
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"CustomerParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
},
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Address": {
"DepartmentCode": "11",
"CityCode": "11001",
"AddressLine": "Calle 97a No. 9 - 45",
"Country": "CO"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"Notes": [
"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum. "
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
},
"DocumentReferences": [
{
"DocumentReferred": "EPOS200",
"IssueDate": "2023-11-27T15:43:09",
"Type": "InvoiceReference",
"DocumentReferredCUFE": "16172af9c0360b1e661a57f6c232474818bd921adb200e0087c54165352f99b"
}
]
}
Términos importantes
A continuación, se describen las secciones clave del mensaje JSON para una Factura Electrónica de Venta:
A nivel global de la factura: Contiene información general como número consecutivo, fecha de emisión, forma y medio de pago, valor total, impuestos y descuentos globales, entre otros.
A nivel de línea: Describe los productos o servicios facturados, con sus respectivos valores unitarios, cantidades, descuentos, impuestos, retenciones, etc.
Emisor: Información completa de la persona natural o jurídica que emite la factura.
Adquiriente: Datos de identificación del receptor del documento (cliente o comprador).
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": "a9d6c173-0cce-4f67-a1c0-d65811c182ad",
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": "EquivalentDocumentAdjust.Currency",
"Code": "Required",
"Description": null,
"ExplanationValues": []
}
],
"ResultData": "00000000-0000-0000-0000-000000000000",
"ResultCode": 400
}
Nota de Ajuste Tipo Débito de Documento Equivalente#
Este documento permite realizar cambios, ajustes y/o correcciones a los documentos equivalentes, generando un cargo adicional al cliente cuando se detecta un cobro inferior en la factura de venta inicialmente transmitida. A través de Saphety, en calidad de Proveedor Tecnológico autorizado por la DIAN, se facilita la generación, transmisión para validación, validación y expedición del documento conforme a los requisitos y definiciones legales del anexo técnico vigente regulado por la DIAN.
A continuación, se describen los métodos y estructuras para la creación de una Nota de Ajuste Tipo Débito de un Documento Equivalente Electrónico.
Creación de una Nota de Ajuste Tipo Débito de un Documento Equivalente (NAD).#
Para consumir la API, es importante tener en cuenta el entorno de trabajo, ya que SOVOS Saphety cuenta con dos ambientes especificados en el apartado de Entornos.
Consumo del método de creación.#
El Verbo Http (acción) que se utiliza para la creación de este documento es:
POST
El método que se utiliza para la creación de este documento es:
/v2/{virtualOperator}/outbounddocuments/equivalentDocumentAdjustAsync
Parameters
Para esta petición se requiere como parámetro el alias de su operador virtual.
Parametro virtualOperator
Recuerde reemplazar en el método el parámetro {virtualOperator} con el alias de su operador virtual en minúsculas, por defecto el alias es “saphety”.
Body#
Estructura del mensaje JSON para una Nota de Ajuste Tipo Débito de un Documento Equivalente#
A continuación, se describen los métodos y la estructura base definida por Saphety para la creación de una Nota de Ajuste Tipo Débito de un Documento Equivalente Electrónico.
JSON (DTO)
{
"IssueDate": "2024-03-27T15:43:09.958Z",
"Currency": "COP",
"DueDate": "2024-03-27T15:43:09.958Z", //*
"DeliveryDate": "2024-03-27T15:43:09.958Z", //*
"SeriePrefix": "NDDE", //**
"SerieNumber": "2500002", //**
"ReasonDebit": "1",
"OperationType": "20",
"SerieExternalKey": "{{serieexternalkeyDEND}}", // No tenemos resolucion de pruebas ya que DIAN no ha desplegado
"CorrelationDocumentId": "POSTMAN-{{$timestamp}}",
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
],
"IssuerParty": {
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
}
},
"CustomerParty": {
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Identification": {
"DocumentNumber": "{{nit}}",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "{{digitoverificacion}}"
},
"Name": "Saphety Transacciones Electrónicas S.A.S",
"Address": {
"DepartmentCode": "11",
"CityCode": "11001",
"AddressLine": "Calle 97a No. 9 - 45",
"Country": "CO"
}
},
"Lines": [
{
"Number": "1",
"Quantity": "1",
"QuantityUnitOfMeasure": "NAR",
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"UnitPrice": "115000.00",
"GrossAmount": "115000.00",
"NetAmount": "115000.00",
"Item": {
"Gtin": "987654321",
"Description": "Descripcion del producto o servicio"
}
}
],
"Notes": [
"Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book. It has survived not only five centuries, but also the leap into electronic typesetting, remaining essentially unchanged. It was popularised in the 1960s with the release of Letraset sheets containing Lorem Ipsum passages, and more recently with desktop publishing software like Aldus PageMaker including versions of Lorem Ipsum. "
],
"TaxSubTotals": [
{
"TaxCategory": "01",
"TaxPercentage": "19.00",
"TaxableAmount": "115000.00",
"TaxAmount": "21850.00"
}
],
"TaxTotals": [
{
"TaxCategory": "01",
"TaxAmount": "21850.00"
}
],
"Total": {
"GrossAmount": "115000.00",
"TotalBillableAmount": "136850.00",
"PayableAmount": "136850.00",
"TaxableAmount": "115000.00",
"AllowancesTotalAmount": "0.00",
"ChargesTotalAmount": "0.00",
"PrePaidTotalAmount": "0.00"
},
"DocumentReferences": [
{
"DocumentReferred": "EPOS200",
"IssueDate": "2023-11-27T15:43:09",
"Type": "InvoiceReference",
"DocumentReferredCUFE": "16172af9c0360b1e661a57f6c232474818bd921adb200e0087c54165352f99b6"
}
]
}
Términos importantes
A continuación, se describen las secciones clave del mensaje JSON para una Factura Electrónica de Venta:
A nivel global de la factura: Contiene información general como número consecutivo, fecha de emisión, forma y medio de pago, valor total, impuestos y descuentos globales, entre otros.
A nivel de línea: Describe los productos o servicios facturados, con sus respectivos valores unitarios, cantidades, descuentos, impuestos, retenciones, etc.
Emisor: Información completa de la persona natural o jurídica que emite la factura.
Adquiriente: Datos de identificación del receptor del documento (cliente o comprador).
Respuesta#
{
"IsValid": true,
"Warnings": [],
"Errors": [],
"ResultData": "a9d6c173-0cce-4f67-a1c0-d65811c182ad",
"ResultCode": 200
}
{
"IsValid": false,
"Warnings": [],
"Errors": [
{
"Field": "EquivalentDocumentAdjust.Currency",
"Code": "Required",
"Description": null,
"ExplanationValues": []
}
],
"ResultData": "00000000-0000-0000-0000-000000000000",
"ResultCode": 400
}
Referencia: Swagger#
Para obtener más información, puedes consultar la documentación del API de SOVOS Saphety en Swagger. A continuación, se indican los enlaces según el ambiente:
Ambiente de QA: https://api-factura-electronica-co-qa.saphety.com/swagger/index.html
Ambiente de Producción: https://api-factura-electronica-co.saphety.com/swagger/index.html