Guía de Integración a Nivel Global (Header)#
Campos generales a nivel global de un documento soporte#
Header#
Especificación y definición de datos del Header del documento Soporte en Adquisiciones efectuadas a sujetos no obligados a Facturar.
1. Logo (DS)
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 (DS)
Nombre documento, establecido por anexo técnico DIAN.
NA
NA
NA
3. Fecha de Emisión (DS)
{
"IssueDate": "2022-01-07T12:35:32",
"DueDate": "2022-01-07T00:00:00",
"DeliveryDate": "2022-01-07T00:00:00"
}
<cbc:IssueDate>2022-01-07</cbc:IssueDate>
<cbc:IssueTime>12:35:32-05:00</cbc:IssueTime>
<cbc:DueDate>2022-01-07</cbc:DueDate>
<cac:Delivery>
<cbc:ActualDeliveryDate>2022-01-07</cbc:ActualDeliveryDate>
<cbc:ActualDeliveryTime>00:00:00-05:00</cbc:ActualDeliveryTime>
</cac:Delivery>
Fecha de emisión: Fecha de generación de la factura aaaa-mm-ddThh:mm:ss.
(IssueDate): Fecha de generación de la factura.
Formato predeterminado: aaaa-mm-dd Fecha de emisión.(IssueTime): Fecha de generación de la factura.
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.
25 CARACTERES
4. Moneda (DS)
{
"Currency": "COP"
}
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
Currency: Divisa del documento. Códigos de moneda en el método del WEB API de Saphety Currencies.
NA
5. Datos del Documento (DS)
{
"SeriePrefix": "SETT", //(2)
"SerieNumber": "999", //(2)
"OperationType": "10",
"CorrelationDocumentId": "1234",
"SerieExternalKey": "REkEmqg9Vh"
}
<cbc:ID>SETT999</cbc:ID>
<cbc:DocumentCurrencyCode>COP</cbc:DocumentCurrencyCode>
<cbc:CustomizationID>10</cbc:CustomizationID>
SeriePrefix: Prefijo de la autorización de numeración del documento dado por el SIE de Numeración.
*Rechazo:- No se permiten caracteres adicionales como espacios o guiones.
SerieNumber: Número/Consecutivo del documento.
Rechazo: No se permiten caracteres adicionales como espacios o guiones.
OperationType: Identificador de residencia fiscal del vendedor.
10 vendedor es residente en Colombia.
11 vendedor NO es residente en Colombia.
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.
24 CARACTERES
6. Datos Resolución (DS)
Viene del sistema (Preconfigurado en la plataforma SaphetyDoc.)
Para solicitar las series de habilitacion siga el siguiente manual de DIAN Manual serie habilitacion para DS.
<sts:InvoiceControl>
<sts:InvoiceAuthorization>18760000001</sts:InvoiceAuthorization>
<sts:AuthorizationPeriod>
<cbc:StartDate>2019-01-19</cbc:StartDate>
<cbc:EndDate>2030-01-19</cbc:EndDate>
</sts:AuthorizationPeriod>
<sts:AuthorizedInvoices>
<sts:Prefix>SETT</sts:Prefix>
<sts:From>1</sts:From>
<sts:To>5000000</sts:To>
</sts:AuthorizedInvoices>
</sts:InvoiceControl>
Nota: Configurar serie para “Documento Soporte” en Saphety.
NA
7. Razón Social y Tipo Contribuyente del Proveedor (DS)
{
"SupplierParty": {
"Name": "Vendedor SAS",
"LegalType": "Legal",
"Email": "correo@correo.com",
"TaxScheme": "01",
"ResponsabilityTypes": [
"R-99-PN"
]
}
}
<cac:AccountingSupplierParty>
<cbc:AdditionalAccountID>1</cbc:AdditionalAccountID>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Vendedor SAS</cbc:RegistrationName>
</cac:PartyTaxScheme>
<cbc:TaxLevelCode>R-99-PN</cbc:TaxLevelCode>
<cac:TaxScheme>
<cbc:ID>01</cbc:ID>
<cbc:Name>IVA</cbc:Name>
</cac:TaxScheme>
</cac:Party>
</cac:AccountingCustomerParty>
Name: Nombre o razón social del proveedor que está registrado en el RUT.
LegalType: Los tipos de personas legales LegalTypes están disponibles en el método del WEB API de Saphety: LegalTypes.
Email: Correo electrónico del adquiriente.
TaxScheme: Identificador del Régimen Fiscal del proveedor, 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 ResponsabilityTypes están disponibles en el método del WEB API de Saphety: ResponsabilityTypes.
45 CARACTERES
8. Datos Proveedor (DS)
{
"SupplierParty": {
"Identification": {
"DocumentNumber": "900900900",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "0"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="0"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)"> 900900900 </cbc:CompanyID>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingSupplierParty>
DocumentNumber: Número de documento del Proveedor.
DocumentType: Tipo de documento del Proveedor, el listado de los tipos de DocumentType están disponibles en el método del WEB API de Saphety: DocumentType.
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.
CheckDigit: DV del NIT del Proveedor.
Important
Para proveedores residentes en Colombia solo es permitido el tipo de identificacion NIT.
36 CARACTERES
9 - 10 - 11. Datos Ubicación Proveedor (DS)
{
"SupplierParty": {
"Address": {
"DepartmentCode": "13",
"CityCode": "13001",
"AddressLine": "Dirección Vendedor",
"PostalCode": "130011",
"Country": "CO"
}
}
}
<cac:AccountingSupplierParty>
<cac:Party>
<cac:PhysicalLocation>
<cac:Address>
<cbc:ID>13001</cbc:ID>
<cbc:CityName>Cartagena De Indias</cbc:CityName>
<cbc:PostalZone>130011</cbc:PostalZone>
<cbc:CountrySubentity>Bolívar</cbc:CountrySubentity>
<cbc:CountrySubentityCode>13 </cbc:CountrySubentityCode>
<cac:AddressLine>
<cbc:Line>Dirección Vendedor</cbc:Line>
</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:AccountingSupplierParty>
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.
9: 45 Caracteres
10: 45 Caracteres
11: 45 Caracteres
12. Razón Social Adquiriente (DS)
Razón Social “Adquiriente SAS” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:RegistrationName>Adquiriente SAS</cbc:RegistrationName>
</cac:PartyTaxScheme>
</cac:Party>
</cac:AccountingCustomerParty>
Texto libre.
36 CARACTERES
13. Datos Adquiriente (DS)
{
"CustomerParty": {
"Identification": {
"DocumentNumber": "830007691",
"DocumentType": "NIT",
"CountryCode": "CO",
"CheckDigit": "2"
}
}
}
<cac:AccountingCustomerParty>
<cac:Party>
<cac:PartyTaxScheme>
<cbc:CompanyID schemeID="2"
schemeName="31"
schemeAgencyID="195"
schemeAgencyName="CO, DIAN (Dirección de Impuestos y Aduanas Nacionales)"> 830007691 </cbc:CompanyID>
</cac:PartyTaxScheme
</cac:Party>
</cac:AccountingCustomerParty>
DocumentNumber: NIT del adquiriente.
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
14. Dirección Adquiriente (DS)
Dirección “Dirección Adquiriente” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cac:AddressLine>
<cbc:Line>Dirección Adquiriente</cbc:Line>
</cac:AddressLine>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
45 CARACTERES
15. Departamento Adquiriente (DS)
Departamento “Bogotá” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cbc:CountrySubentity>Bogotá</cbc:CountrySubentity>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
18 CARACTERES
16. Municipio Adquiriente (DS)
Municipio “Bogotá D.C.” viene de sistema (Preconfigurado en la plataforma SaphetyDoc).
<cac:PhysicalLocation>
<cac:Address>
<cbc:CityName>Bogotá D.C.</cbc:CityName>
</cac:Address>
</cac:PhysicalLocation>
Texto libre.
30 CARACTERES
Otros. Forma de Pago (DS)
{
"PaymentMeans": [
{
"Mean": "1",
"Code": "20",
"DueDate": "2021-08-03"
}
]
}
<cac:PaymentMeans>
<cbc:ID>1</cbc:ID>
<cbc:PaymentMeansCode>20</cbc:PaymentMeansCode>
<cbc:PaymentDueDate>2021-08-03</cbc:PaymentDueDate>
</cac:PaymentMeans>
PaymentMeans: Grupo de campos para información relacionadas con el pago del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente.
Mean: Método de pago. Los códigos del método de pago están disponibles en el método del WEB API de Saphety: PaymentMeansMeansCode.
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.
DueDate: Fecha del plazo de la forma de pago cuando es crédito, Formato predeterminado: aaaa-mm-dd
NA