API LaFactura.co:Whisp ModCustomer
Sumario
Objeto: modCustomer (Modificar cliente)
Este servicio te permite modificar 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)
{
"modCustomer":{
"customer":"900900900",
"name":"Pepito Perez y compañía SAS",
"taxInfo":"R-99-PN",
"countrySubentity":"05001",
"addressLine":"Cra 21 No. 21 21",
"telephone":"573210000000",
"email":"[email protected]"
}
}
Campos
Envía la información referente al cliente a modificar
| Parámetro | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| customer | NIT o cédula del cliente a modificar .. sin puntos, guiones o dígitos de verificación | 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 |
| countrySubentity | Código del municipio según tabla DIAN consultar tabla |
cadena | SI |
| addressLine | Dirección física del cliente | cadena | SI |
| telephone | Número telefónico del cliente | cadena | SI |
| Correo electronico del cliente Pueden ser varios separados por ";". |
cadena | SI |
Resultados
Devuelve un objeto result con el resultado de la operación
{
"result":{
"status":{
"code": 200,
"text":"Registro modificado con exito",
},
"customer": {
"additionalAccountID": "1",
"name":"Pepito Perez y compañía SAS",
"taxInfo": "R-99-PN",
"countryName": "Colombia",
"countryCode": "CO",
"city": "MEDELLÍN",
"countryEntity": "05",
"countrySubentity":"05001",
"addressLine":"Cra 21 No. 21 21",
"documentType": "31",
"documentNumber": "900900900",
"telephone":"573210000000",
"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 |
| 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
- 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.