Diferencia entre revisiones de «API LaFactura.co:UNSPSC»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 29: Línea 29:
  
 
=====Resultados=====
 
=====Resultados=====
 +
 +
  {
 +
        "generalResult":{
 +
            "status":{
 +
              "code":200,
 +
              "text":"Operación realizada con exito"
 +
            },
 +
            "data":[
 +
              {
 +
                "code":"10000000",
 +
                "es":"Material Vivo Vegetal y Animal, Accesorios y Suministros"
 +
              },
 +
              {
 +
                "code":"11000000",
 +
                "es":"Material Mineral, Textil y Vegetal y Animal No Comestible"
 +
              },
 +
              .
 +
              .
 +
              .
 +
              {
 +
                "code":"95000000",
 +
                "es":"Terrenos, Edificios, Estructuras y Vías"
 +
              }
 +
            ]
 +
        }
 +
  }
  
 
==== Familias ====
 
==== Familias ====

Revisión del 20:41 27 jul 2020

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
Resultados
  {
       "generalResult":{
           "status":{
              "code":200,
              "text":"Operación realizada con exito"
           },
           "data":[
              {
                "code":"10000000",
                "es":"Material Vivo Vegetal y Animal, Accesorios y Suministros"
              },
              {
                "code":"11000000",
                "es":"Material Mineral, Textil y Vegetal y Animal No Comestible"
              },
              .
              .
              .
              {
                "code":"95000000",
                "es":"Terrenos, Edificios, Estructuras y Vías"
              }
           ]
        }
  }

Familias

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

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getFamilies": {
                  "lang":"es",
                  "segment":"10"
            }
      }
 }
Objeto
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"
            }
      }
 }
Objeto
Parámetro Descripción Tipo Obligatorio
version Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80 cadena SI
getClasses Objeto para obtener clases objeto SI
lang Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles) cadena SI
family Familia del cual se desean todas las clases (4 dígitos) cadena SI

Productos

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

 {
      "UNSPSC":{
           "version":"v14.0.80",
           "getProducts": {
                  "lang":"es",
                  "class":"105016"
            }
      }
 }
Objeto
Parámetro Descripción Tipo Obligatorio
version Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80 cadena SI
getProducts Objeto para obtener productos objeto SI
lang Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles) cadena SI
class clase del cual se desean obtener los productos (6 dígitos) cadena SI

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"
            }
      }
 }
Objeto
Parámetro Descripción Tipo Obligatorio
version Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80 cadena SI
getProductByCode Objeto para obtener información de un producto objeto SI
lang Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles) cadena SI
code Código del producto (8 dígitos) cadena SI

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
Parámetro Descripción Tipo Obligatorio
version Versión de UNSPSC a ser utilizada .. debe contener: v14.0.80 cadena SI
getProductByText Busca productos por texto objeto SI
lang Idioma de la respuesta (en->Inglés, es->Español, all->Todos los idiomas disponibles) cadena SI
segment Segmento en el que se desea buscar (2 dígitos) cadena SI
text Texto que se desea buscar 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

Temas complementarios

Enlaces

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.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:UNSPSC&oldid=636»