API LaFactura.co:Customer

Objeto:customer

Es un objeto usado en invoice. Permite enviar al sistema, los datos referentes al cliente. Su uso es obligatorio para la generación de cualquier factura.

Ejemplo

     "customer":{
          "additionalAccountID":"1",
          "name":"Pepito Perez y Compania S.A.",
          "countryName":"Colombia",
          "countryCode":"CO",
          "city":"Bogotá D.C.",
          "countryEntity":"11",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected]",
          "emailStyle":"0"
     }

Campos

---

Parámetro	Descripción	Tipo	Obligatorio	API
additionalAccountID	Tipo de cliente "1" -> es persona jurídica "2" ->es persona natural	cadena	SI	v2.0 / v3.0
name	Nombre de la empresa o persona	cadena	SI	v2.0 / v3.0
taxInfo	Datos referentes a las responsabilidades fiscales del contribuyente Es reponsabilidad enviar la información de la mejor manera posible. No nos hacemos responsables por inconvenientes por mala clasificacion por parte de quien envía los datos, ó por los datos por omision colocados por nuestro sistema Se recomienda ampliamente hacer el envio de esta informacion En caso de no enviarse se asumirá la siguiente: * Si es Factura nacional, persona natural -> R-99-PN * Si es Factura nacional, persona juridica -> R-99-PJ * Si es Factura de exportacion -> R-00-PN Puede colocarse mas de una olbigación, separada por ";" consultar tabla	cadena	NO	v3.0
countryName	Nombre completo del pais de compra (Por omisión "Colombia") Obligatorio si documentType=42 (Debe tener algo diferente a "Colombia")	cadena	SI/NO	v2.0 / v3.0
countryCode	Código ISO de dos letras del país de compra (Por omisión "CO") .. en mayúsculas Obligatorio si documentType=42 (Debe tener algo diferente a "CO") Usa ISO 3166-1 Aplha 2. Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2	cadena	SI/NO	v2.0 / v3.0
city	Ciudad del cliente que compra	cadena	SI	v2.0 / v3.0
countryEntity	Código del departamento según DIAN (Si es al extranjero no es necesario) consultar tabla	cadena	SI/NO	v2.0 / v3.0
countrySubentity	Código del municipio según tabla DIAN (Si es al extranjero no es necesario) consultar tabla	cadena	SI/NO	v2.0 / v3.0
addressLine	Dirección física del cliente	cadena	SI	v2.0 / v3.0
documentType	Tipo de documento según la DIAN consultar tabla	cadena	SI	v2.0 / v3.0
documentNumber	Identificación tributaria del cliente Si documentType<>"42"-> Debes colocar este campo sin puntos, rayas o dígitos de verificación	cadena	SI	v2.0 / v3.0
telephone	Número telefónico del cliente	cadena	SI	v2.0 / v3.0
email	correo electronico del cliente Es el correo al cual se enviará la factura una vez sea aprobada por la DIAN Debe ser solo uno -> API v2.0 Pueden ser varios separados por ";" -> API 3.0 El primero se considera el registable en el XML, los demás son únicamente de envio de correo.	cadena	SI	v2.0 / v3.0
emailStyle	Sistema como se accede a los documentos enviados por correo 0->Enlace de descarga (Por omision API 2.0) (Convertido a "2" automaticamente en API v3.0) 1->Como archivos adjuntos (Convertido a "2" automaticamente en API v3.0) 2->Acrhivos adjuntos y Asunto homologado DIAN (Por omision API 3.0) 99->No se envia correo	cadena	NO	v2.0 / v3.0

Notas para migrantes de API v2.0 a v3.0:

---

Se agregó taxInfo (MUY IMPORTANTE)
Se verifica que el countrySubentity corresponda con el countryEntity (municipio con departamento)
Se cambió el emailStyle por defecto a "2"
Se agregó la posibilidad de enviar a mas de un correo simultáneamente

Usado por

Los siguientes recursos:

• Generar Factura

Los siguientes objetos:

• invoice

Temas complementarios

• Facturación

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.