
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 NCDS
Numero inicial 1
Numero final 1000000
{
"sToken": "00000000000",
"jApi": {
"sMethod": "classTaxxa.fjDocumentExternalAdd",
"jParams": {
"wEnvironment": "test",
"jDocument": {
"wdocumenttype": "ReverseCreditNote",
"wdocumenttypecode": "95",
"tduedate": "2025-01-13",
"tissuedate": "2025-01-13",
"tissuetime": "14:01:00",
"rdocumenttemplate": 30884303,
"sauthorizationprefix": "NCDS",
"sdocumentsuffix": "224001",
"wcurrency": "USD",
"spaymentmethod": "30",
"yisresident": "Y",
"sinvoiceperiod": "1",
"snotesa": "Sin comentarios",
"wdocumentsubtype": "2",
"jdocumentitems": {
"1": {
"wproductcodetype": "999",
"scustomname": "Alquiler de plataforma en la nube para capacitación de facturación electrónica mes de Enero 2025",
"nunitprice": 2848421,
"nUserTotal": 2848421,
"wunitcode": "UND",
"nquantity": 1,
"sstandarditemidentification": "GIRRPV15",
"sdescription": "Alquiler de plataforma en la nube para capacitación de facturación electrónica mes de Enero 2025"
}
},
"jbuyer": {
"wlegalorganizationtype": "company",
"sbuyername": "TAXXA S.A.S",
"staxlevelcode": "R-99-PN",
"jpartylegalentity": {
"wdoctype": "nit",
"sdocno": "000000000",
"scorporateregistrationschemename": "TAXXA S.A.S"
},
"jcontact": {
"scontactperson": "Nombre",
"selectronicmail": "correo",
"stelephone": "00000000",
"jregistrationaddress": {
"scountrycode": "co",
"wdepartmentcode": "11",
"wtowncode": "11001",
"scityname": "Bogotá, Bogotá D.C",
"saddressline1": "Direccion",
"szip": "110211"
}
}
},
"jseller": {
"wlegalorganizationtype": "person",
"sdocid": "000000000",
"sdoctype": "nit",
"ssellername": "NOMBRE DE LA PERSONA",
"scontactperson": "CONTACTO",
"semail": "",
"sphone": "00000000",
"saddressline1": "dirección",
"saddresszip": "110211",
"wdepartmentcode": "11",
"wtowncode": "11001",
"scityname": "Bogotá"
},
"jbillingreference": {
"sbillingreferenceid": "DSC224",
"sbillingreferenceissuedate": "2025-01-12",
"sbillingreferenceuuid": "7411070e8151adbb065bcc2ffea98befc28c32ea570464022f710705417011aaa383250fa"
}
}
}
}
}
Campo | Descripción | ||||||||||||
«wdocumenttype»: «ReverseCreditNote», | Para generar la nota de ajuste al Documento soporte, debe venir por defecto el nombre ReverseCreditNote | ||||||||||||
«wdocumenttypecode»: «95», | Envie por defecto 95 para la Nota de Ajuste a 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. | ||||||||||||
«snotesa»: «Sin comentarios» | Para las Notas de ajuste es importante enviar los comentarios que indiquen el motivo de la anulación, se recomienda usar los motivos que encuentra en el campo wdocumentsubtype tome la descripción. | ||||||||||||
«wdocumentsubtype»: «2», | Corresponde al código del tipo de Ajuste anexo catalogo
| ||||||||||||
«wcurrency»: «USD»,
| Moneda del documento soporte si no envia la moneda pro defecto se tomara COP pesos colombianos |
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.