API LaFactura.co:Whisp Customer

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

Objeto:customer (Datos de clientes)

Este servicio te permite conocer todos los datos de un cliente específico del sistema. Puedes hacer la consulta usando POST en la URL del servicio e incluir el siguiente objeto. 

    Ingreso:     
    https://***.tas-la.com/whisp.v10/customer/
     
    Solicita tu usuario y contraseña +57-601-7466664
    No cobramos por el proceso de pruebas o desarrollo
    Y puedes empezar inmediatamente (sin certificados o papeleos)



 {
      "customer":"900900900"
 }
Campos

Envía la información referente al cliente a consultar

Parámetro Descripción Tipo Obligatorio
customer NIT o cédula del cliente a consultar .. sin puntos, guiones o dígitos de verificación cadena SI
Resultados

Devuelve un objeto result con el resultado de la operación 

 {
   "result":{
       "status":{
          "code": 200,
          "text":"Operación realizada con exito",
       },
       "customer": {
          "additionalAccountID": "1",
          "name": "PEPITO PEREZ Y CIA SAS",
          "taxInfo": "R-99-PN",
          "countryName": "Colombia",
          "countryCode": "CO",
          "city": "BOGOTÁ",
          "countryEntity": "11",
          "countrySubentity": "11001",
          "addressLine": "CRA 21 NO. 21-21",
          "documentType": "31",
          "documentNumber": "900900900",
          "telephone": "601-21212121",
          "email": "[email protected]",
          "emailDIAN": {
             "email": "[email protected]",
             "lastUpdate": "20191104"
           },
           "legal": {
             "name": "PEPITO PEREZ Y CIA SAS",
             "additionalName": "",
             "fullID": "NIT 900900900 - 6",
             "status": "ACTIVA",
             "city": "BOGOTA",
             "intID": "21212121",
             "type": "SOCIEDADES POR ACCIONES SIMPLIFICADAS SAS"
           }
         }
       }
     }


Objeto:result

Informa los estados de error sobre el proceso realizado

Parámetro Descripción Tipo Obligatorio
code Código de estado
200 -> Resultado OK
201 -> Sólo se obtuvo el EMAIL de la DIAN
>=1000 Error		 cadena SI
text Texto explicativo del estado cadena SI


Objeto:customer

Contiene la relacion completa de información de clientes. El mismo contiene siempre los siguientes campos:

Parámetro Descripción Tipo Obligatorio
additionalAccountID Tipo de cliente
"1" -> es persona jurídica
"2" ->es persona natural		 cadena SI
name Nombre de la empresa o persona cadena SI
taxInfo Datos referentes a las responsabilidades fiscales:
* O-13 -> Gran contribuyente
* O-15 -> Autorretenedor
* O-23 -> Agente de retención de IVA
* O-47 -> Regimen simple de tributacion
* R-99-PN -> No Aplica - Otros
Puede contener mas de una obligación, separada por ";" (punto y coma)		 cadena SI
countryName Nombre completo del pais cadena SI
countryCode Código ISO de dos letras del país
Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2		 cadena SI
city Ciudad del cliente cadena SI
countryEntity Código del departamento según DIAN
consultar tabla		 cadena SI
countrySubentity Código del municipio según tabla DIAN
consultar tabla		 cadena SI
addressLine Dirección física del cliente cadena SI
documentType Tipo de documento según la DIAN
consultar tabla		 cadena SI
documentNumber Identificación tributaria del cliente cadena SI
telephone Número telefónico del cliente cadena SI
email Correo electronico del cliente
Pueden ser varios separados por ";".		 cadena SI
emailDIAN Información relacionada por la DIAN acerca del correo de facturación vinculado en su portal
En personas naturales no registradas en la DIAN aparece en null		 objeto NO
emailDIAN/email Correo reportado en la DIAN para facturación (puede ser null) cadena SI
emailDIAN/lastUpdate Ultima actualización del correo en la DIAN cadena SI
legal Datos tomados del portal del RUES
Puede ser null
En el proceso Actual (2023.09.01) Aún no tenemos todos los registros activos con esta información		 objeto NO
legal/name Nombre legal de la empresa cadena SI
legal/additionalName Siglas de la empresa cadena SI
legal/fullID NIT Completo cadena SI
legal/Status Estado de registro en cámara de comercio cadena SI
legal/city Ciudad cadena SI
legal/intID Numero de registro en la cámara cadena SI
legal/type Tipo de empresa cadena SI

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:Whisp_Customer&oldid=2480»