Guía de Integración a Nivel Global (Header)#
Campos generales a nivel global de una nota crédito genérica#
Header#
El Header (encabezado) de la Nota Crédito contiene la información general del documento, la cual identifica y relaciona los datos principales del emisor, el adquiriente y las condiciones generales de emisión.
A continuación, se presenta la especificación y definición de los datos del Header de la Nota Crédito, considerando el escenario en el que el adquiriente dispone de información completa.
1. Logo (NC)
Logo viene del sistema (Pre configurado en la plataforma SaphetyDoc.)
Se debe visualizar en la parte superior izquierda
NA
Tamaño en pixeles Horizontal: 180px Vertical: 70 px
2. Tipo de Documento (NC)
{
"SeriePrefix": "NC",
"SerieNumber": "120",
"CorrelationDocumentId": "POSTMAN-120",
"SerieExternalKey": "5vjX+aBptT",
"OperationType": "20"
}
<cbc:ID>NC120</cbc:ID>
<cbc:ActualDeliveryDate>2023-11-27</cbc:ActualDeliveryDate>
<cbc:CustomizationID>20</cbc:CustomizationID>
SeriePrefix: Prefijo definido por el emisor, maximo 4 caracteres.
*Rechazo:- No se permiten caracteres adicionales como espacios o guiones.
SerieNumber: Número de documento: Número de la nota crédito.
Incluye prefijo + consecutivo de NC definido por el emisor.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
CorrelationDocumentId: Es un identificador único del sistema de generación del emisor y debe tener un máximo de 36 caracteres.
SerieExternalKey: El campo SerieExternalKey se obtiene realizando la consulta por el método API o consultando en el portal administrativo de Saphety.
OperationType: El listado de los diferentes tipos de operación están disponibles en el método del WEB API de Saphety: OperationType. Sin embargo, los tipos de operación para Nota crédito son:
Tipo Operación 20, Nota Crédito obligatorio, referencia a facturas.
Tipo Operación 22, Nota Crédito sin referencia a facturas.
24 CARACTERES
3. Moneda (NC)
{
"Currency": "COP"
}
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
Currency: Código de moneda debe ser igual a COP
Rechazo: Si el valor de este elemento no corresponde a “COP”.
25 CARACTERES
4 - 5. Forma de Pago (NC)
{
"PaymentMeans": [
{
"Code": "20", //(5)
"Mean": "1", //(4)
"DueDate": "2023-11-27"
}
]
}
<cac:PaymentMeans>
<cbc:ID>1</cbc:ID><!-- (4) -->
<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode><!-- (5) -->
<cbc:PaymentDueDate>2023-11-27</cbc:PaymentDueDate>
</cac:PaymentMeans>
Code: Código correspondiente al método de pago, el listado de los tipos de PaymentMeans están disponibles en el método del WEB API de Saphety: PaymentmeansCode.
Mean: Los códigos de las formas de pago paymentmeansmeans están disponibles en el método del WEB API de Saphety: PaymentMeansMeans.
DueDate: Fecha del plazo de la forma de pago cuando es crédito, Formato predeterminado: aaaa-mm-dd
4:25 CARACTERES
5:25 CARACTERES
6. Razón de Crédito (NC)
{
ReasonCredit: "5"
}
<cac:DiscrepancyResponse>
<cbc:ReferenceID>SETP990040002</cbc:ReferenceID>
<cbc:ResponseCode>5</cbc:ResponseCode>
<cbc:Description>Devolución de parte de los bienes; no aceptación de partes del servicio</cbc:Description>
</cac:DiscrepancyResponse>
ReasonCredit: Los códigos de las causales de una nota crédito CreditNoteReasons están disponibles en el método del WEB API de Saphety: CreditNoteReasons
80 CARACTERES
7. Fecha de Emisión (NC)
{
"IssueDate": "2023-11-27T12:12:12", //(Formato para JSON: aaaa-mm-ddThh:mm:ss)
"DueDate": 2"023-11-27T12:12:12",
"DeliveryDate": "2023-11-27T12:12:12"
}
<cbc:IssueDate>2023-11-27</cbc:IssueDate>
<cbc:IssueTime>12:12:12-05:00</cbc:IssueTime>
Fecha de emisión: Fecha de generación de la NC aaaa-mm-ddThh:mm:ss.
(IssueDate): Fecha de generación de la NC.
Formato predeterminado: aaaa-mm-dd Fecha de emisión.(IssueTime): Fecha de generación de la NC.
Formato predeterminado: hh:mm:ss
Rechazo: La fecha de emisión debe ser igual a la fecha de firma de la NC.
DueDate: Fecha de pago.
Formato predeterminado: aaaa-mm-ddThh:mm:ss.
DeliveryDate: Fecha efectiva de entrega de los bienes y/o servicios.
Formato predeterminado: aaaa-mm-ddThh:mm:ss
Rechazo: Si ActualDeliveryDate < IssueDate.
25 CARACTERES
8. Fecha Validación DIAN (NC)
NA
Solo es visible en el xml firmado por DIAN (ApplitacionResponse).
Fecha Validación DIAN.
25 CARACTERES
9. Tipo de Nota (NC)
Tipo de Nota
<cbc:CreditNoteTypeCode>91</cbc:CreditNoteTypeCode>
NA
25 CARACTERES
Información del Emisor a nivel global de una Nota Crédito genérica.#
10. Datos Emisor (NC)
{
"IssuerParty": {
"Identification": {
"DocumentNumber": "900606963",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "4"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="4" schemeName="31" schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">900606963</cbc:CompanyID>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
DocumentNumber: NIT del emisor Rechazo: NIT no autorizado a facturar electrónicamente.
DocumentType: Tipos de documento, el listado de los tipos de identificación están disponibles en el método del WEB API de Saphety: identificationDocumentTypes.
CountryCode: Los códigos de los países countrycodes están disponibles en el método del WEB API de Saphety: CountryCode.
CheckDigit: Digito de Verificación del NIT del emisor.
36 CARACTERES
11. Tipo de Contribuyente (NC)
Tipo de Contribuyente “Persona Jurídica” viene de sistema (Pre configurado en la plataforma SaphetyDoc).
<cac:AccountingCustomerParty>
<cbc:AdditionalAccountID schemeAgencyID="195">1</cbc:AdditionalAccountID>
</cac:AccountingCustomerParty>
Tipo de contribuyente: Los códigos del tipo de contribuyente están disponibles en el método del WEB API de Saphety: LegalTypes.
36 CARACTERES
12. Correo (NC)
“Correo “fedemo@saphety.com” viene de sistema (Pre configurado en la plataforma SaphetyDoc.)”
<cac:AccountingSupplierParty>
<cac:Party>
<cac:Contact>
<cbc:ElectronicMail>fedemo@saphety.com</cbc:ElectronicMail>
</cac:Contact>
</cac:Party>
</cac:AccountingSupplierParty>
Texto para indicar la dirección de correo electrónico.
36 CARACTERES
13. Información Tributaria (NC)
“Información Tributaria “Impuesto sobre las ventas – IVA” + “Gran contribuyente, Autorretenedor, Agente de retención en el impuesto sobre las ventas, Régimen Simple de Tributación – SIMPLE”, viene del sistema (Pre configurado en la plataforma SaphetyDoc).”
<cac:AccountingSupplierParty>
<cbc:TaxLevelCode listName="48">O-13,O-15,O-23,O-47</cbc:TaxLevelCode>
</cac:AccountingSupplierParty>
Régimen Fiscal: Debe corresponder a uno de los regímenes fiscales disponibles en el endpoint.
TaxScheme Responsabilidades fiscales:
O-13 Gran contribuyente.
O-15 Autorretenedor.
O-23 Agente de retención en el impuesto sobre las ventas.
O-47 Régimen Simple de Tributación – SIMPLE.
Los códigos de Régimen Fiscal están disponibles en el método del WEB API de Saphety: ResponsabilityTypes.
210 caracteres 2 líneas
14. Razón Social (NC)
“Razón Social “FE DEMO” viene de sistema (Pre configurado en la plataforma SaphetyDoc.)”
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:RegistrationName>FE DEMO</cbc:RegistrationName>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
Texto libre.
45 CARACTERES
15. Dirección (NC)
“Dirección “Calle 78 # 3-56” viene de sistema (Pre configurado en la plataforma SaphetyDoc.)”
<cac:PhysicalLocation>
<cac:Address>
<cac:AddressLine>
<cbc:Line>Calle 78 # 3-56</cbc:Line>
</cac:AddressLine>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
45 CARACTERES
16. Departamento (NC)
“Departamento “Bogotá” viene de sistema (Pre configurado en la plataforma SaphetyDoc.)”
<cac:PhysicalLocation>
<cac:Address>
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
30 CARACTERES
17. Municipio (NC)
“Municipio “Bogotá D.c.” viene de sistema (Pre configurado en la plataforma SaphetyDoc.)
<cac:PhysicalLocation>
<cac:Address>
<cbc:CityName>Bogotá D.c</cbc:CityName>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
30 CARACTERES
Información del Adquiriente a nivel global de una Nota Crédito genérica para persona Jurídica o Natural.#
18. Datos del Adquiriente (NC)
{
// Si el Adquiriente es de tipo Legal
"CustomerParty": {
"Identification": {
"DocumentNumber": "900606963",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "4"
}
},
//Si el Adquiriente es de tipo Natural
"CustomerParty": {
"Identification": {
"DocumentNumber": "123456789",
"DocumentType": "CitizenshipCard",
"CountryCode": "CO"
}
}
}
<!-- Si el Adquiriente es de tipo Legal -->
<cac:AccountingCustomerParty>
<cac:Party><cac:PartyTaxScheme>
<cbc:CompanyID schemeID="4" schemeName="31" schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">900606963</cbc:CompanyID>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:PartyTaxScheme></cac:Party>
</cac:AccountingCustomerParty>
<!-- Si el Adquiriente es de tipo Natural -->
<cac:AccountingCustomerParty>
<cac:Party><cac:PartyTaxScheme>
<cbc:CompanyID schemeName="13" schemeAgencyID="195" schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">123456789</cbc:CompanyID>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:PartyTaxScheme></cac:Party>
</cac:AccountingCustomerParty>
DocumentNumber: Número de documento del adquiriente.
Rechazo:
NIT no autorizado a facturar electrónicamente
Nit o Documento de Identificación informado No corresponde al registrado en el RUT con respecto a la razón social o nombre comercial suministrado.
DocumentType: Tipo de documento, el listado de los tipos de DocumentType están disponibles en el método del WEB API de Saphety: DocumentType.
CheckDigit: DV del NIT del Adquiriente.
CountryCode: Código identificador del país, el listado de los tipos de CountryCode están disponibles en el método del WEB API de Saphety: CountryCode.
36 CARACTERES
19 - 23. Razón Social y Tipo Contribuyente del Adquiriente (NC)
{
// Si es de tipo LegalType = Legal
"CustomerParty": {
"LegalType": "Legal", // (19)
"Name": "Saphety Transacciones Electrónicas S.A.S" // (23)
},
// Si es de tipo natural LegalType= Natural
"CustomerParty": {
"LegalType": "Natural", // (19)
"Person": { // (23)
"FirstName": "FirstName",
"MiddleName": "MiddleName",
"FamilyName": "FamilyName"
}
}
}
<!-- Si es de tipo LegalType = Legal -->
<cac:AccountingCustomerParty>
<cbc:AdditionalAccountID schemeAgencyID="195">1</cbc:AdditionalAccountID><!-- (19) -->
<cac:Party><cac:PartyName>
<cbc:Name>Saphety Transacciones Electrónicas S.A.S</cbc:Name><!-- (23) -->
</cac:PartyName></cac:Party>
</cac:AccountingCustomerParty>
<!-- Si es de tipo Natural LegalType = Natural -->
<cac:AccountingCustomerParty>
<cbc:AdditionalAccountID schemeAgencyID="195">2</cbc:AdditionalAccountID><!-- (19) -->
<cac:Party><cac:PartyName>
<cbc:Name>FirstName MiddleName FamilyName</cbc:Name><!-- (23) -->
</cac:PartyName></cac:Party>
</cac:AccountingCustomerParty>
LegalType: Los tipos de personas legales LegalTypes están disponibles en el método del WEB API de Saphety: LegalTypes
Name: Nombre o razón social del adquiriente que está registrado en el RUT.
45 CARACTERES
20. Impuesto Principal (NC)
{
"CustomerParty": {
"TaxScheme": "ZZ" //(20)
"ResponsabilityTypes":["R-99-PN"]
}
}
<cac:AccountingCustomerParty>
<cac:TaxScheme>
<cbc:ID>ZZ</cbc:ID> <!-- (20) -->
<cbc:Name>No Aplica</cbc:Name>
</cac:TaxScheme>
</cac:AccountingCustomerParty>
TaxScheme: Identificador del Régimen Fiscal del adquirente, el listado de los tipos de TaxScheme están disponibles en el método del WEB API de Saphety: TaxScheme.
ResponsabilityTypes: Los códigos de las responsabilidades RepresentationTypes están disponibles en el método del WEB API de Saphety: RepresentationTypes.
36 CARACTERES
21 - 22. Correo (NC)
{
"CustomerParty": {
"TeleFax": "1234567",
"Email": “correo@sovos.com” //(21)
}
}
<cac:AccountingCustomerParty>
<cac:Party><cac:Contact>
<cbc:Telefax>1234567</cbc:Telefax>
<cbc:ElectronicMail>correo@sovos.com</cbc:ElectronicMail><!-- (21) -->
</cac:Contact></cac:Party>
</cac:AccountingCustomerParty>
Email: Correo electrónico del adquiriente.
21: 36 CARACTERES
24 - 25 - 26. Datos Ubicación (FV)
{
"CustomerParty": {
"Address": {
"DepartmentCode": "11", //(25)
"CityCode": "11001", //(26)
"AddressLine": " Calle 97a No. 9 - 45", //(24)
"PostalCode": "110221",
"Country": "CO"
}
}
}
<cac:AccountingCustomerParty>
<cac:Party><cac:PhysicalLocation>
<cac:Address>
<cbc:ID>11001</cbc:ID> <!-- (26) -->
<cbc:CityName>Bogota D.C.</cbc:CityName> <!-- (26) -->
<cbc:PostalZone>110221</cbc:PostalZone> <!-- (25) -->
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode> <!-- (25) -->
<cac:AddressLine>
<cbc:Line>Calle 97a No. 9 - 45</cbc:Line> <!-- (24) -->
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:Address>
</cac:PhysicalLocation></cac:Party>
</cac:AccountingCustomerParty>
DepartmentCode: Los códigos de los departamentos DepartmentCode están disponibles en el método del WEB API de Saphety: DeparmentCode.
CityCode: Los códigos de los países CityCode están disponibles en el método del WEB API de Saphety: CityCode.
AddressLine: Elemento de texto libre, que el emisor puede utilizar para poner toda la información de la dirección del adquirente, en lugar de utilizar elementos estructurados.
PostalCode: Los códigos postales PostalCode están disponibles en el método del WEB API de Saphety: PostalCode.
Country: Los códigos de los paises CountryCodes están disponibles en el método del WEB API de Saphety: CountryCode.
Important
Debe tener encuentra que los códigos de DepartmentCode, CityCode y PostalCode deben cumplir con la referencia geográfica, es decir no se permite informar códigos postales o códigos de ciudades que no correspondan con el departamento.
24: 45 CARACTERES
25: 45 CARACTERES
26: 45 CARACTERES
Header Consumidor Final#
Esta sección describe la estructura y definición de los datos que conforman el encabezado (Header) de una Nota Crédito, en el caso en que el adquiriente no dispone de información completa o cuando la operación corresponde a un consumidor final.
En este escenario, algunos campos del adquiriente se completan con información genérica o valores predefinidos, de acuerdo con las disposiciones establecidas por la DIAN y las buenas prácticas de interoperabilidad electrónica.
Note
Este caso aplica cuando el adquiriente no proporciona la información completa, como el nombre o la identificación tributaria. En estos casos, se debe remitir a la DIAN la información estandarizada correspondiente, conforme a los lineamientos establecidos para operaciones con consumidor final.
1. Consumidor Final (NC)
{
"CustomerParty": {
"IsFinalConsumer": true
}
}
<cac:AccountingCustomerParty>
<cac:Party><cac:PartyTaxScheme>
<cbc:RegistrationName>Consumidor Final</cbc:RegistrationName>
<cbc:CompanyID schemeName="13">2222222222</cbc:CompanyID>
</cac:PartyTaxScheme></cac:Party>
</cac:AccountingCustomerParty>
IsFinalConsumer: Se debe informar el texto “True” cuando se trate de informar al consumidor final.
Identificación del adquirente, Para identificar al consumidor final, se utiliza el siguiente documento “222222222222” Para informar al consumidor final del bien o servicio se debe indicar el siguiente texto “consumidor final”
Nit: 22 CARACTERES
Razón Social: 45 CARACTERES
Dirección: 45 CARACTERES