deprecated

Actualización en los items de DSE y NADSE

El día 26/11 se actualizará el campo items del documento soporte y nota de ajuste documento soporte que romperá la retro-compatibilidad con la versión anterior.

Razón del cambio

Previamente en el campo items se enviaba la propiedad code dentro de items como una propiedad de texto plano (string) y se asumía que el standard del código era 999 (Estándar de adopción del contribuyente) por lo cual este se enviaba por defecto sin oportunidad de poder modificarlo.

Solución

En esta actualización se creo el campo standardCode de tipo object en el cual se debe especificar en el campo identificationId cual es el identificador del item (StandardItemIdentification) y de manera opcional se puede enviar el campo id en el cual especificar cual es el standard a utilizar, los posibles valores son:

  • "001" : UNSPSC-Colombia Compra Eficiente
  • "010": GTIN-Números Globales de Identificación de Productos
  • "020": Partida arancelaria según estatus tributario
  • "999": Estándar de adopción del contribuyente

En caso de no enviar el campo id se envia por defecto el codigo 999

Ejemplos de Request:

Previamente como se enviaba solamente el campo code dentro de items:

{ 
	"items":[
    {
      "code": "4312"
      ...
    }
  ],
  ...
}

Pero después del cambio debe enviarse dentro del campo standardCode en la propiedad identificationId

{ 
	"items":[
    {
      "standardCode":{
      	"identificationId": "4312"
      }
      ...
    }
  ],
  ...
}

Y para especificar el estándar del código debe enviarse en el campo id

{ 
	"items":[
    {
      "standardCode":{
      	"identificationId": "4312",
        "id": "001" // otros valores posibles: "010", "020", "999"
      }
      ...
    }
  ],
  ...
}

Consideraciones

A partir del 26/11 el campo code quedará completamente deprecado y el campo standardCode pasa a ser obligatorio dentro de los items.

Recomendación

Para estar preparado para la nueva actualización se recomienda de momento enviar ambos campos, de la siguiente manera:

{ 
	"items":[
    {
      "code": "4312",
      "standardCode":{
      	"identificationId": "4312"
      }
      ...
    }
  ],
  ...
}

Es decir, enviando ambas propiedades, la propiedad standardCode se ignoraría de momento y posterior a la publicación de la actualización se podría quitar el campo code sin problemas.