JSON. Nota de Ajuste a documento soporte

pexels-saramazin-20206395

Método de envío.

Para el proceso de pruebas  recuerde

  1. Solicitar el TOKEN
  2. 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"
                }
            }
        }
    }
}
				
			
CampoDescripció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

  1. contado

  2. Crédito

«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:

  1. Y—>  Residente

  2. N—>  No Residente 

«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

CodDescripción
1Devolución parcial de los bienes y/o no aceptación parcial del servicio
2

Anulación del documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura de venta o documento equivalente.

3

Rebaja o descuento parcial o total

4Ajuste de precio
5Otros

 

«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.

CampoDescripció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.

CODIGOTIPORESIDENTENO RESIDENTE
TETarjeta de extranjería X
CECédula de extranjería X
NITNITX 
PASPasaporte X
DEXDocumento de identificación extranjero X
PEPPEP X
FINIT 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)

CODIGOIMPUESTODESCRIPCIÓN

01

IVAImpuestos sobre las Ventas
05ReteIVARetención sobre el IVA
06ReteRentaRetención Sobre Renta
 ReteicaRetención Ica

Importante el ambiente de pruebas de Dian para DS  presentará el siguiente  mensaje al mometno de emitir.

«0»: «Regla: DSAB08b, Rechazo: Fecha final del rango de numeración informado no corresponde a la fecha final del rango vigente para el ABS»,
«1»: «Regla: DSAD05b, Rechazo: Número de documento soporte en adquisiciones efectuadas a sujetos no obligados a expedir factura o documento equivalente es inferior al número inicial del rango de numeración autorizado».
Si solo se visualiza este mensaje  y ningun otro mensaje de error indicará que puede emitir en  producción. 
 
RECUERDE QUE  ES IMPORTANTE QUE PARA LAS PRUEBAS DE ANULACIÓN DE LAS  NOTAS  DE AJUSTE DEBE ENVIAR UN CUDS  DE PRUEBAS.