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.",
          "taxInfo":"R-99-PN",
          "city":"Bogotá D.C.",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected];[email protected]"
     }

Ejemplo 2

---

Consumidor Final:

     "customer":{
          "additionalAccountID":"2", *
          "name":"consumidor final", *
          "taxInfo":"R-99-PN", *
          "city":"No Reporta",
          "countrySubentity":"11001",
          "addressLine":"No Reporta",
          "documentNumber":"222222222222", *
          "documentType":"13", *
          "telephone":"00000000",
          "email":"[email protected]"
     }

Los campos con * los debes mantener con dichos valores, los demás los puedes modificar

Ejemplo 3

---

Consumidor Final:

     "customer":"consumidor final"

Este método, coloca el objeto del ejemplo 2, de ser utilizado

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: * 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 En caso de no enviarse se asumirá -> "R-99-PN" Puede colocarse mas de una obligación, separada por ";" (punto y coma)	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
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
internalID	Campo adicional de información vinculante del cliente Normalmente es una información complementaria No obligatoria que sirve para identificar el cliente y enviada de retorno en procesos complementarios - Webhooks y correos de notificaciones -	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

---

Si no se conocen los datos del cliente se deben usar los siguientes:

• additionalAccountID = "2"
• name = "consumidor final"
• taxInfo = "R-99-PN"
• documentType = "13"
• documentNumber = "222222222222"
• telephone = "00000000"
• email = si el cliente dió alguno -> colocarlo, de lo contrario usar "[email protected]"
• Los campos de direccion pueden tener los de la empresa que genera el documento

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.