Método de envío.
Para el proceso de pruebas recuerde
- Solicitar el TOKEN
- Valide el parámetro de envió para pruebas
«sMethod»: «classTaxxa.fjDocumentExternalAdd»,
“jParams”: {
“wVersionUBL”: 2.1,
“wEnvironment”: “test”,
El ambiente de producción debe ajustar el parámetro de la siguiente forma:
«sMethod»: «classTaxxa.fjDocumentExternalAdd»,
“jParams”: {
“wVersionUBL”: 2.1,
“wEnvironment”: “prod”,
RANGO PARA PRUEBAS
PREFIJO SEDS
Numero inicial 99000000
Numero final 99400000
{
"sToken": "00000000000",
"iNonce": 15,
"jApi": {
"sMethod": "classTaxxa.fjDocumentExternalAdd",
"jParams": {
"sEnvironment": "test",
"jDocument": {
"sdocumentprefix": "SEDS",
"wdocumenttype": "ReverseInvoice",
"wdocumenttypecode": "05",
"wpaymentmeans": "2",
"spaymentmethod": "ZZZ",
"tissuedate": "2024-05-22",
"tduedate": "2024-06-21",
"sdocumentsuffix": "21",
"sinvoiceperiod": "1",
"yisresident": "Y",
"rdocumenttemplate": 30884303,
"nlineextensionamount": 1440000,
"ntaxinclusiveamount": 1440000,
"npayableamount": 1440000,
"snotes": "",
"wcurrency": "COP",
"jseller": {
"wlegalorganizationtype": "person",
"staxlevelcode": "R-99-PN",
"sdocid": "00000000",
"sdoctype": "NIT",
"ssellername": "nombre del vendedor",
"scontactperson": "nombre de contacto",
"semail": "correo@correo.co",
"sphone": "4410465",
"saddressline1": "CRA 2410A 40",
"saddresszip": "",
"wdepartmentcode": "76",
"wtowncode": "76001",
"sdepartmentname": "VALLEDUPAR",
"scityname": "CALI"
},
"jbuyer": {
"wlegalorganizationtype": "company",
"sbuyername": "TAXXA SAS",
"staxlevelcode": "R-99-PN",
"jpartylegalentity": {
"wdoctype": "NIT",
"sdocno": "901402281",
"scorporateregistrationschemename": "TAXXA SAS"
},
"jcontact": {
"scontactperson": "Nombre del Contacto",
"selectronicmail": "correo@correo.co",
"stelephone": "0000000000",
"jregistrationaddress": {
"saddressline1": "direccion",
"scountrycode": "CO",
"wdepartmentcode": "11",
"sdepartmentname": "BOGOTA",
"scityname": "BOGOTA",
"wtowncode": "11001",
"szip": "110001"
}
}
},
"jtax": {
"jreterenta": {
"nrate": 2.5,
"sname": "ReteRenta",
"nvalue": 36000,
"nbaseamount": 1440000
},
"jreteica2": {
"nrate": 0.77,
"sname": "ReteICA",
"nvalue": 11088,
"nbaseamount": 1440000
}
},
"jextrainfo": {
"mivaservices": 0,
"musersubtotal": 1440000,
"musertotal": 1440000,
"ssalespersonname": "",
"iitemscount": 1
},
"jdocumentitems": {
"1": {
"jextrainfo": {
"sbarcode": "00260"
},
"sdescription": "GUANTE INGENIERO REFORZADO CON PUNO 15 CMS CON VAQ",
"sstandarditemidentification": "GIRRPV15",
"nunitprice": 8000,
"nUserTotal": 1440000,
"nquantity": 180,
"wunitcode": "ZZ",
"wproductcodetype": "999",
"adescription": {
"0": "2024-05-22"
}
}
},
"idocprecision": 2
}
}
}
}
| Campo | Descripción |
«wdocumenttype»: «Factura Inversa», | Para generar documento soporte a sujetos no obligados el tipo de documento se debe enviar como ReverseInvoice, valor Fijo |
«wdocumenttypecode»: «05», | Envie por defecto 05 para Documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente |
«wpagomedios»: «1», | Indique el código del metodo de pago
|
«yisresidente»: «N», | Es importante que se indique si el prestador del servidor reside o no en Colombia, de esto dependera la correcta generación del Documento:
|
«rdocumenttemplate»: 30884303, | Enviar valor fijo 30884303 |
«sinvoiceperiod»: «1», | Indique la forma de generación y transmisión del documento 1—->Por operación 2—->Acumulado semanal recuerde que la Norma indica que el documento Soporte se debe transmitir diario con la operación que se realiza, o el ultimo día habil de la semana Aumulado por tercero. |
Es importante tener en cuenta los tipos de documento del vendedor.
| Campo | Descripción |
«sdoctype»: «NIT», | Validar documentos de identidad en el catalogo tipos de documento Recuerde que para emitir DS a residentes en Colombia Solo se pueden generar con NIT no se permite CC, consulto los códigos de los documentos abajo. |
| CODIGO | TIPO | RESIDENTE | NO RESIDENTE |
| TE | Tarjeta de extranjería | X | |
| CE | Cédula de extranjería | X | |
| NIT | NIT | X | |
| PAS | Pasaporte | X | |
| DEX | Documento de identificación extranjero | X | |
| PEP | PEP | X | |
| FI | NIT de otro país | X |
A nivel del Documento Soporte puede generar iva y retenciones a nivel de item o retenciones a nivel de documento (Recuerde e IVA no se debe enviar a nivel de Documento solo a nivel del Item)
| CODIGO | IMPUESTO | DESCRIPCIÓN |
01 | IVA | Impuestos sobre las Ventas |
| 05 | ReteIVA | Retención sobre el IVA |
| 06 | ReteRenta | Retención Sobre Renta |
| Reteica | Retención Ica |
Importante el ambiente de pruebas de Dian para DS presentará el siguiente mensaje al mometno de emitir.