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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Objeto:supplier== Es un objeto usado en invoice. Permite enviar al sistema, los datos referentes al proveedor no obligado a emitir factura. Su uso es obligatorio para la…»)
 
 
(No se muestran 47 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
 
==Objeto:supplier==
 
==Objeto:supplier==
  
−
Es un objeto usado en invoice. Permite enviar al sistema, los datos referentes al proveedor no obligado a emitir factura. Su uso es obligatorio para la generación de cualquier documento soporte.
+
Es un objeto usado en invoice. Permite enviar al sistema, los datos referentes al proveedor no obligado a emitir factura. Su uso es obligatorio para la generación de documentos soporte.
  
 
=====Ejemplo=====
 
=====Ejemplo=====
Línea 8: Línea 8:
 
           "additionalAccountID":"1",
 
           "additionalAccountID":"1",
 
           "name":"Pepito Perez y Compania S.A.",
 
           "name":"Pepito Perez y Compania S.A.",
−
          "city":"Bogotá D.C.",
 
−
          "countryEntity":"11",
 
 
           "countrySubentity":"11001",
 
           "countrySubentity":"11001",
 
           "addressLine":"Av 25 No. 8-47",
 
           "addressLine":"Av 25 No. 8-47",
Línea 15: Línea 13:
 
           "documentType":"31",
 
           "documentType":"31",
 
           "telephone":"3112196952",
 
           "telephone":"3112196952",
−
          "email":"[email protected]",
 
−
          "emailStyle":"0"
 
 
       }
 
       }
  
Línea 26: Línea 22:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
|-
 
|-
−
| additionalAccountID || Tipo de cliente<br><small>"1" -> es persona jurídica<br>"2" ->es persona natural</small> || cadena || SI || v2.0 / v3.0
+
| additionalAccountID || Clasificacion del Proveedor<br><small>"1" -> persona jurídica y asimiladas<br>"2" -> persona natural y asimiladas</small> || cadena || SI || v3.0
 
|-
 
|-
−
| name || Nombre de la empresa o persona || cadena || SI || v2.0 / v3.0
+
| name || Nombre de la empresa o persona || cadena || SI || v3.0
 
|-
 
|-
−
| taxInfo || Datos referentes a las responsabilidades fiscales del contribuyente<br><small>Es reponsabilidad enviar la información de la mejor manera posible.<br/>No nos hacemos responsables por inconvenientes por mala clasificacion por parte de quien envía los datos,<br/>ó por los datos por omision colocados por nuestro sistema<br/><b>Se recomienda ampliamente hacer el envio de esta informacion</b><br/>En caso de no enviarse se asumirá la siguiente:<br>* Si es Factura nacional, persona natural -> R-99-PN<br/>* Si es Factura nacional, persona juridica -> R-99-PJ<br/>* Si es Factura de exportacion -> R-00-PN<br/><br/>Puede colocarse mas de una olbigación, separada por ";" [[API_LaFactura.co:Tabla_Tipos_Obligaciones_DIAN|consultar tabla]]</small>|| cadena || NO || v3.0
+
| taxInfo || Datos referentes a las responsabilidades fiscales:<br><small>* O-13 -> Gran contribuyente<br/>* O-15 -> Autorretenedor<br/>* O-23 -> Agente de retención de IVA<br/>* O-47 -> Regimen simple de tributacion<br/>* R-99-PN -> No Aplica - Otros<br/>En caso de no enviarse se asumirá -> "R-99-PN"<br/>Puede colocarse mas de una obligación, separada por ";" (punto y coma)</small>|| cadena || NO || v3.0
 
|-
 
|-
−
| city || Ciudad del cliente que compra || cadena || SI || v2.0 / v3.0
+
| countryCode || Código ISO de dos letras del país de compra<br><small><b>CO -> Convierte al proveedor en Residente</b><br/><b>Cualquier otro valor considera al proveedor NO Residente</b><br>Usa ISO 3166-1 Aplha 2.<br>Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2<br/>(Valor Por omisión "CO") .. en mayúsculas</small> || cadena || NO || v3.0
 
|-
 
|-
−
| countryEntity || Código del departamento según DIAN<br><small>(Si es al extranjero no es necesario)<br>[[API_LaFactura.co:Tabla_Departamentos|consultar tabla]]</small> || cadena || SI/NO || v2.0 / v3.0
+
| countryName || Nombre completo del pais de compra<br><small>(Por omisión "Colombia")</small>|| cadena || NO || v3.0
 
|-
 
|-
−
| countrySubentity || Código del municipio según tabla DIAN<br><small>(Si es al extranjero no es necesario)<br>[[API_LaFactura.co:Tabla_Municipios|consultar tabla]]</small> || cadena || SI/NO || v2.0 / v3.0
+
| city || Ciudad del proveedor|| cadena || SI || v3.0
 
|-
 
|-
−
| addressLine || Dirección física del cliente || cadena || SI || v2.0 / v3.0
+
| countrySubentity || Código del municipio según tabla DIAN<br/><b><small>(Solo requerido para residentes)<br/>(Ignorado para NO residentes)</small></b><br><small>[[API_LaFactura.co:Tabla_Municipios|consultar tabla]]</small> || cadena || SI/NO || v3.0
 
|-
 
|-
−
| documentType || Tipo de documento según la DIAN<br><small>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI || v2.0 / v3.0
+
| postalZone || Código Postal del proveedor|| cadena || NO || v3.0
 
|-
 
|-
−
| documentNumber || Identificación tributaria del cliente<br><small>Si documentType<>"42"-> Debes colocar este campo sin puntos, rayas o dígitos de verificación</small>|| cadena || SI || v2.0 / v3.0
+
| addressLine || Dirección física del proveedor || cadena || SI || v3.0
 
|-
 
|-
−
| telephone || Número telefónico del cliente || cadena || SI || v2.0 / v3.0
+
| documentType || Tipo de documento según la DIAN<br><small>(Debe contener "31" -> NIT si es <b>Residente</b>)<br/>(Debe contener "21"/"22"/"31"/"41"/"42"/"47"/"50" si <b>NO Residente</b>)<br/>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI || v3.0
 
|-
 
|-
−
| email || correo electronico del cliente<br/><small>Es el correo al cual se enviará la factura una vez sea aprobada por la DIAN<br/>Debe ser solo uno -> API v2.0<br/>Pueden ser varios separados por ";" -> API 3.0<br/>El primero se considera el registable en el XML, los demás son únicamente de envio de correo.</small> || cadena || SI || v2.0 / v3.0
+
| documentNumber || Identificación tributaria del proveedor<br><small>Debes colocar este campo sin puntos, rayas o dígitos de verificación</small>|| cadena || SI || v3.0
 
|-
 
|-
−
| emailStyle || Sistema como se accede a los documentos enviados por correo<br><small>0->Enlace de descarga <b>(Por omision API 2.0)</b> (Convertido a "2" automaticamente en API v3.0)<br/>1->Como archivos adjuntos (Convertido a "2" automaticamente en API v3.0)<br/>2->Acrhivos adjuntos y Asunto homologado DIAN <b>(Por omision API 3.0)</b><br/>99->No se envia correo</small> || cadena || NO || v2.0 / v3.0
+
| telephone || Número telefónico del proveedor || cadena || SI || v3.0
 
|}
 
|}
  

Revisión actual del 02:41 25 abr 2022

Objeto:supplier

Es un objeto usado en invoice. Permite enviar al sistema, los datos referentes al proveedor no obligado a emitir factura. Su uso es obligatorio para la generación de documentos soporte.

Ejemplo
     "supplier":{
          "additionalAccountID":"1",
          "name":"Pepito Perez y Compania S.A.",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
     }
Campos
Parámetro Descripción Tipo Obligatorio API
additionalAccountID Clasificacion del Proveedor
"1" -> persona jurídica y asimiladas
"2" -> persona natural y asimiladas		 cadena SI v3.0
name Nombre de la empresa o persona cadena SI 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
countryCode Código ISO de dos letras del país de compra
CO -> Convierte al proveedor en Residente
Cualquier otro valor considera al proveedor NO Residente
Usa ISO 3166-1 Aplha 2.
Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2
(Valor Por omisión "CO") .. en mayúsculas		 cadena NO v3.0
countryName Nombre completo del pais de compra
(Por omisión "Colombia")		 cadena NO v3.0
city Ciudad del proveedor cadena SI v3.0
countrySubentity Código del municipio según tabla DIAN
(Solo requerido para residentes)
(Ignorado para NO residentes)
consultar tabla		 cadena SI/NO v3.0
postalZone Código Postal del proveedor cadena NO v3.0
addressLine Dirección física del proveedor cadena SI v3.0
documentType Tipo de documento según la DIAN
(Debe contener "31" -> NIT si es Residente)
(Debe contener "21"/"22"/"31"/"41"/"42"/"47"/"50" si NO Residente)
consultar tabla		 cadena SI v3.0
documentNumber Identificación tributaria del proveedor
Debes colocar este campo sin puntos, rayas o dígitos de verificación		 cadena SI v3.0
telephone Número telefónico del proveedor cadena SI v3.0

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

Es nuevo en el API v3.0, y permite la generacion de Documentos de Soporte

Usado por

Los siguientes recursos:

Los siguientes objetos:

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:Supplier&oldid=2171»