API LaFactura.co:UNSPSC

UNSPSC

Es el estándard internacional de clasificación de productos creado por las Nacciones Unidas y utilizado por gran cantidad de países entre los que se encuentra Colombia. Este servicio consta de varios tipos de consulta por el método GET

Segmentos

Método Segmentos: Devulve el conjunto completo de segmentos del standard

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getSegments": {
                  "lang":"es"
            }
      }
 }

Objeto

Parámetro	Descripción	Tipo	Obligatorio
version	Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80	cadena	SI
getSegments	Objeto para obtener segmentos	objeto	SI
lang	Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles)	cadena	SI

Familias

Método Familias: Devuelve todas las familias pertenecientes a un segmento

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getFamilies": {
                  "lang":"es",
                  "segment":"10"
            }
      }
 }

Objeto

Envía la información referente al documento a anular:

Parámetro	Descripción	Tipo	Obligatorio
version	Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80	cadena	SI
getFamilies	Objeto para obtener familias	objeto	SI
lang	Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles)	cadena	SI
segment	Segmento del cual se desean las familias (2 dígitos)	cadena	SI

Clases

Método Clases: Devuelve todas las clases pertenecientes a una familia

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getClasses": {
                  "lang":"es",
                  "family":"1050"
            }
      }
 }

Productos

Método Productos: Devuelve todos los productos pertenecientes a una clase

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getProducts": {
                  "lang":"es",
                  "class":"105016"
            }
      }
 }

Producto por código

Método por código: Devuelve toda la información referente a un código UNSPSC.

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getProductByCode": {
                  "lang":"es",
                  "code":"10501601"
            }
      }
 }

Producto por texto

Método de búsqueda por texto: Devuelve todos los códigos que en su texto contengan el "texto", entre un segmento dado.

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getProductByText": {
                  "lang":"es",
                  "segment":"10",
                  "text":"chile"
            }
      }
 }

Objeto

Envía la información referente al documento a anular:

Parámetro	Descripción	Tipo	Obligatorio
mode	Que rangos deseo consultar: active ->Activos inactive-> Inactivos	cadena	SI
type	Que tipo de rangos deseo: all -> Todos invoice -> Facturas creditNote -> Nota Credito debitNote -> Nota Debito	cadena	SI

Resultados

Devuelve un objeto generalResult con el resultado de la operación y la información referente a los rangos

    {
         "generalResult":{
             "status":{
                "code":200,
                "text":"Operación realizada con exito"
              },
              "ranges":[
                 {
                   "rangeKey":"rk-c1cbededb62c3546c19ad0676cca4cb85",
                   "type":"invoice",
                   "prefix":"SETP",
                   "from":"990000000",
                   "to":"995000000",
                   "last":"990000102"
                 },
                 {
                   "rangeKey":"rk-009e51a3986e10aad892275fb1e72594a",
                   "type":"creditNote",
                   "prefix":"NCR",
                   "from":"0",
                   "to":"999999999",
                   "last":"17"
                 },
                 {
                    "rangeKey":"rk-ad664ee282763d4f89870b653ac5b90e8",
                    "type":"debitNote",
                    "prefix":"NDE",
                    "from":"0",
                    "to":"999999999",
                    "last":"11"
                  }
             ]
         }
      }

ranges

Información referente a los rangos solicitados (Es un arreglo):

Parámetro	Descripción	Tipo	Obligatorio
rangeKey	Llave del rango Es requerido para enviar una factura	cadena	SI
type	Tipo de rango invoice -> Factura debitNote -> Nota Debito creditNote -> Nota Credito	cadena	SI
prefix	Prefijo de facturacion	cadena	SI
from	Primer numero del rango	cadena	SI
to	Ultimo numero del rango	cadena	SI
last	Ultimo numero usado	cadena	SI

A tener presente

• rangeKey es la llave requerida para enviar solicitud de una factura al sistema
• Si se solicitan los rangos activos, solamente aparecerá un rango por cada tipo de documento generable

Objetos Empleados

• generalResult: Resultado General

Temas complementarios

• Procesos Generales

Enlaces

• LaFactura.co: https://lafactura.co
• GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co

Importante

Recuerda que nosotros no te cobramos absolutamente nada por que pruebes nuestra plataforma.
Si deseas tener un usuario y contraseña , comunícate con nosotros.