Guía de Integración a Nivel Global (Header)#
Campos generales a nivel global de un Documento Equivalente POS#
Header#
A continuación se presenta la especificación y definición de los datos que conforman el encabezado (Header) del Documento Equivalente Electrónico POS. Estos datos son obligatorios para la correcta identificación y procesamiento del documento, y deben cumplir con los requisitos establecidos por la normativa vigente y la DIAN.
1. Logo (DE)
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. Nombre Documento (DE)
Nombre documento, establecido por anexo técnico DIAN.
NA
NA
NA
3. Fecha de Emisión y Moneda (DE)
{
"IssueDate": "2022-01-07T12:35:32",
"DueDate": "2022-01-07T00:00:00",
"DeliveryDate": "2022-01-07T00:00:00",
"Currency": "COP”
}
<cbc:IssueDate>2023-11-27</cbc:IssueDate>
<cbc:IssueTime>15:43:09-05:00</cbc:IssueTime>
<cbc:DueDate>2023-11-27</cbc:DueDate>
<cac:Delivery>
<cbc:ActualDeliveryDate>2023-11-27</cbc:ActualDeliveryDate>
<cbc:ActualDeliveryTime>15:43:09-05:00</cbc:ActualDeliveryTime>
</cac:Delivery>
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
Fecha de emisión: Fecha de generación del documento aaaa-mm-ddThh:mm:ss.
(IssueDate): Fecha de generación del documento.
Formato predeterminado: aaaa-mm-dd Fecha de emisión.(IssueTime): Fecha de generación del documento.
Formato predeterminado: hh:mm:ss
Rechazo: La fecha de emisión debe ser igual a la fecha de firma de la factura.
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.
Currency: Los código de los tipos de moneda están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/currencies.
25 CARACTERES
4. Tipo de Documento (DE)
{
"SeriePrefix": "SETP", //( 4 )
"SerieNumber": "990008032", //( 4 )
"SerieExternalKey": "REkEmqg9Vh",
"CorrelationDocumentId": "123456abc*"
}
<cbc:ID>SETT990008032</cbc:ID> <!-- ( 4 ) -->
SerieExternalKey (clave externa): es utilizada para la generación de documentos y es configurada en el mensaje de integración JSON, esta se obtiene de la plataforma de Saphety (No visible en el XML).
SeriePrefix: Prefijo de la autorización de numeración de Documento Equivalente POS dado por el SIE de Numeración.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
SerieNumber: Consecutivo de la numeración de Documento Equivalente POS dado por el SIE de Numeración.
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 50 caracteres (No visible en el XML).
24 CARACTERES
5 - 9. Datos Emisor (DE)
{
"IssuerParty": {
"Identification": {
"DocumentNumber": "900606963",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "4"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyName>
<cbc:Name>Saphety Transacciones Electrónicas S.A.S</cbc:Name>
</cac:PartyName>
<cac:PhysicalLocation>
<cac:Address>
<cbc:ID>11001</cbc:ID>
<cbc:CityName>Bogotá, D.c. </cbc:CityName><!-- (9) -->
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity><!-- (8) -->
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Calle 97a No. 9 - 45</cbc:Line><!-- (7) -->
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:Address>
</cac:PhysicalLocation>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Saphety Transacciones Electrónicas S.A.S</cbc:RegistrationName><!-- (5) -->
<cbc:CompanyID schemeID="4"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)">900606963
</cbc:CompanyID><!-- (6) -->
<cbc:TaxLevelCode>O-13</cbc:TaxLevelCode>
<cac:RegistrationAddress>
<cbc:ID>11001</cbc:ID>
<cbc:CityName>Bogotá, D.c. </cbc:CityName>
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Edifício Strategic 97, Calle 97, N.º 9 - 45, Oficina 207</cbc:Line>
</cac:AddressLine>
<cac:Country>
<cbc:IdentificationCode>CO</cbc:IdentificationCode>
<cbc:Name languageID="es">Colombia</cbc:Name>
</cac:Country>
</cac:RegistrationAddress>
<cac:TaxScheme>
<cbc:ID>01</cbc:ID>
<cbc:Name>IVA</cbc:Name>
</cac:TaxScheme>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
DocumentNumber: NIT del emisor.
DocumentType: Valida el Tipo de identificador fiscal. Los tipos de identificación están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/IdentificationDocumentTypes.
CountryCode: código del país del emisor. Los códigos del país están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/countrycodes.
CheckDigit: Digito de Verificación del NIT del emisor.
Nota: Los demás datos del emisor vienen Pre configurado en la plataforma SaphetyDoc.
45 Caracteres (5)
36 Caracteres (6)
45 Caracteres (7)
45 Caracteres (8)
45 Caracteres (9)
10. Razón Social (DE)
{
"CustomerParty": { //Si es persona jurídica = Legal
"LegalType": "Legal",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Name": "Saphety Transacciones Electrónicas S.A.S"//(10)
},
"CustomerParty": { //Si es persona natural= Natural
"LegalType": "Natural",
"Email": "correo@sovos.com",
"TaxScheme": "ZZ",
"ResponsabilityTypes": [
"R-99-PN"
],
"Person": {
"FirstName": "FirstName",//(10)
"MiddleName": "MiddleName",//(10)
"FamilyName": "FamilyName"//(10)
}
}
}
<cac:AccountingCustomerParty><!-- Si es persona jurídica = 1 -->
<cbc:AdditionalAccountID schemeAgencyID="195">1 </cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyName>
<cbc:Name> Saphety Transacciones Electrónicas S.A.S </cbc:Name><!-- (10) -->
</cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty><!-- Si es persona natural= 2 -->
<cac:AccountingCustomerParty>
<cbc:AdditionalAccountID schemeAgencyID="195">2 </cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyName>
<cbc:Name>FirstName MiddleName FamilyName</cbc:Name><!-- (10) -->
</cac:PartyName>
</cac:Party>
</cac:AccountingCustomerParty>
LegalType: Identificador de tipo de organización. Los tipos de organización están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/legaltypes.
Email: Correo electrónico de notificación del adquiriente.
TaxScheme: Identificador del tributo. Los tipos de taxscheme están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/taxschemes.
ResponsabilityTypes: Obligaciones o responsabilidades del contribuyente; incluye el régimen al que pertenece el vendedor.
Los tipos de responsabilidades están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/ResponsabilityTypes.
45 CARACTERES
11. Datos del Adquiriente (DE)
{
// 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.
Rechazo: 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
12 - 13 - 14. Datos Ubicación (DE)
{
"CustomerParty": {
"Address": {
"DepartmentCode": "11", //(13)
"CityCode": "11001", //(14)
"AddressLine": " Calle 97a No. 9 - 45", //(12)
"PostalCode": "110221",
"Country": "CO"
}
}
}
<cac:AccountingCustomerParty>
<cac:Party><cac:PhysicalLocation>
<cac:Address>
<cbc:ID>11001</cbc:ID> <!-- (14) -->
<cbc:CityName>Bogota D.C.</cbc:CityName> <!-- (14) -->
<cbc:PostalZone>110221</cbc:PostalZone> <!-- (13) -->
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
<cbc:CountrySubentityCode>11</cbc:CountrySubentityCode> <!-- (13) -->
<cac:AddressLine>
<cbc:Line>Calle 97a No. 9 - 45</cbc:Line> <!-- (12) -->
</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.
Country: Los códigos de los paises CountryCodes están disponibles en el método del WEB API de Saphety: CountryCode.
12: 45 CARACTERES
13: 45 CARACTERES
14: 45 CARACTERES
Forma de Pago (DE)
{
"PaymentMeans": [
{
"Code": "20",
"Mean": "1",
"DueDate": "2023-11-27"
}
]
}
<cac:PaymentMeans>
<cbc:ID>1</cbc:ID>
<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2023-11-27</cbc:PaymentDueDate>
</cac:PaymentMeans>
Mean: Método de pago, Los códigos de las Método de pago paymentmeansmeans están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/paymentmeansmeans
Code: Medio de pago, Los códigos de los medios de pago están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/paymentmeanscode
DueDate: Fecha de vencimiento de la factura o fecha de compromiso de pago.
Obligatorio: si es venta a crédito.
Rechazo: si PaymentMeans/ID = 2 y PaymentDueDate no es informado.
NA
Información Beneficios de Comprador (DE)
{
//Extensión Información Beneficios del Comprador:
//**Nota:** Esta sección es opcional.
"BuyerBenefits": {
"BuyerIdentificationDocumentNumber": "900606963",
"BuyerIdentificationName": "Saphety Transacciones Electrónicas S.A.S",
"Points": "200"
}
}
<ext:UBLExtension>
<ext:ExtensionContent>
<ext:VeneficiosComprador>
<ext:InformacionVeneficiosComprador>
<ext:Name>Codigo</ext:Name>
<ext:Value>900606963</ext:Value>
</ext:InformacionVeneficiosComprador>
<ext:InformacionVeneficiosComprador>
<ext:Name>NombresApellidos</ext:Name>
<ext:Value> Saphety Transacciones Electrónicas S.A.S </ext:Value>
</ext:InformacionVeneficiosComprador>
<ext:InformacionVeneficiosComprador>
<ext:Name>Puntos</ext:Name>
<ext:Value>200</ext:Value>
</ext:InformacionVeneficiosComprador>
</ext:VeneficiosComprador>
</ext:ExtensionContent>
</ext:UBLExtension>
BuyerIdentificationDocumentNumber: Valor de la característica que se quiere informar (Código del comprador).
BuyerIdentificationName: Valor de la característica que se quiere informar (Nombres y apellidos del comprador).
Points: Valor de la característica que se quiere informar (Cantidad de Puntos acumulados por el comprador).
NA
Información Caja (DE)
{
Extensión Información de la Caja de Venta:
**Nota:** Esta sección es opcional.
"POSInformation": {
"InventoryBoxPlate": "PV123",
"InventoryBoxLocation": "Entrada1",
"VendorName": "John Doe",
"InventoryBoxType": "Caja Rapida",
"SalesCode": "SC00001",
"SalesSubTotal": "136850.00"
}
}
<ext:UBLExtension>
<ext:ExtensionContent>
<ext:PuntoVenta>
<ext:InformacionCajaVenta>
<ext:Name>PlacaCaja</ext:Name>
<ext:Value>PV123</ext:Value>
</ext:InformacionCajaVenta>
<ext:InformacionCajaVenta>
<ext:Name>UbicaciónCaja</ext:Name>
<ext:Value>Entrada1</ext:Value>
</ext:InformacionCajaVenta>
<ext:InformacionCajaVenta>
<ext:Name>Cajero</ext:Name>
<ext:Value>John Doe</ext:Value>
</ext:InformacionCajaVenta>
<ext:InformacionCajaVenta>
<ext:Name>TipoCaja</ext:Name>
<ext:Value>Caja Rapida</ext:Value>
</ext:InformacionCajaVenta>
<ext:InformacionCajaVenta>
<ext:Name>CódigoVenta</ext:Name>
<ext:Value>SC00001</ext:Value>
</ext:InformacionCajaVenta>
<ext:InformacionCajaVenta>
<ext:Name>SubTotal</ext:Name>
<ext:Value>136850.00</ext:Value>
</ext:InformacionCajaVenta>
</ext:PuntoVenta>
</ext:ExtensionContent>
</ext:UBLExtension>
</ext:UBLExtensions>
InventoryBoxPlate: Valor de la característica que se quiere informar (Placa de inventario de la Caja).
InventoryBoxLocation: Valor de la característica que se quiere informar (Ubicación de la caja ALMACEN).
VendorName: Valor de la característica que se quiere informar (nombres y apellidos del cajero o vendedor).
InventoryBoxType: Valor de la característica que se quiere informar (Tipo de Caja).
SalesCode: Valor de la característica que se quiere informar (Código de la Venta).
SalesSubTotal: Valor de la característica que se quiere informar (Subtotal de la venta).
NA
Tipo de Operación (DE)
{
"OperationType": "10"
}
<cbc:CustomizationID>10</cbc:CustomizationID>
OperationType: Indicador del tipo de operación.
Los códigos de los tipos de operacion están disponibles en el método del WEB API de Saphety: https://api-factura-electronica-co-qa.saphety.com/v2/dataelements/docoperationtypes.
NA
Información Fabricante Software (DE)
{
//Extensión Información Fabricante de Software POS
"SoftwareMaker": {
"LegalName": "Saphety Transacciones Electrónicas S.A.S",
"NameAndLastname": "SOVOS Saphety",
"SoftwareName": "SaphetyDoc"
}
}
<FabricanteSoftware>
<InformacionDelFabricanteDelSoftware>
<Name>NombreApellido</Name>
<Value> SOVOS Saphety</Value>
<Name>RazonSocial</Name>
<Value> Saphety Transacciones Electrónicas S.A.S <Value>
<Name>NombreSoftware</Name>
<Value>SaphetyDoc </Value>
</InformacionDelFabricanteDelSoftware>
</FabricanteSoftware>
LegalName: Razón social del fabricante de Software POS.
NameAndLastname: Nombres y apellidos del fabricante de Software POS.
SoftwareName: Nombre del Software POS.
NA