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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 17 ediciones intermedias del mismo usuario)
Línea 7: Línea 7:
 
       "supplier":{
 
       "supplier":{
 
           "additionalAccountID":"1",
 
           "additionalAccountID":"1",
−
          "additionalAccountType":"01",
 
 
           "name":"Pepito Perez y Compania S.A.",
 
           "name":"Pepito Perez y Compania S.A.",
 
           "countrySubentity":"11001",
 
           "countrySubentity":"11001",
Línea 14: Línea 13:
 
           "documentType":"31",
 
           "documentType":"31",
 
           "telephone":"3112196952",
 
           "telephone":"3112196952",
−
          "email":"[email protected]"
 
 
       }
 
       }
  
Línea 25: Línea 23:
 
|-
 
|-
 
| additionalAccountID || Clasificacion del Proveedor<br><small>"1" -> persona jurídica y asimiladas<br>"2" -> persona natural y asimiladas</small> || cadena || SI || 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
−
|-
 
−
| additionalAccountType || Tipo de Proveedor<br><small>01 -> residente<br>02 -> NO residente</small> || cadena || SI || v3.0
 
 
|-
 
|-
 
| name || Nombre de la empresa o persona || cadena || SI || v3.0
 
| name || Nombre de la empresa o persona || cadena || SI || v3.0
Línea 32: Línea 28:
 
| 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
 
| 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 proveedor (Solo requerido para NO residentes) || cadena || SI/NO || 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
 
|-
 
|-
−
| countrySubentity || Código del municipio según tabla DIAN (Solo requerido para NO residentes)<br><small>[[API_LaFactura.co:Tabla_Municipios|consultar tabla]]</small> || cadena || SI/NO || v3.0
+
| countryName || Nombre completo del pais de compra<br><small>(Por omisión "Colombia")</small>|| cadena || NO || v3.0
 +
|-
 +
| city || Ciudad del proveedor|| cadena || SI || 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
 
|-
 
|-
 
| postalZone || Código Postal del proveedor|| cadena || NO || v3.0
 
| postalZone || Código Postal del proveedor|| cadena || NO || v3.0
Línea 40: Línea 40:
 
| addressLine || Dirección física del proveedor || cadena || SI || v3.0
 
| addressLine || Dirección física del proveedor || cadena || SI || 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>)[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI || 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
 
|-
 
|-
 
| 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
 
| 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
 
|-
 
|-
 
| telephone || Número telefónico del proveedor || cadena || SI || v3.0
 
| telephone || Número telefónico del proveedor || cadena || SI || v3.0
−
|-
 
−
| email || correo electronico del proveedor<br/><small>Es el correo al cual se enviará el documento soporte una vez sea aprobado por la DIAN<br/>Pueden ser varios separados por ";"<br/>El primero se considera el registable en el XML, los demás son únicamente de envio de correo.</small> || cadena || SI || v3.0
 
−
|-
 
−
| emailStyle || Sistema como se accede a los documentos enviados por correo<br><small>2->Archivos adjuntos y Asunto homologado DIAN <b>(Por omision)</b><br/>99->No se envia correo</small> || cadena || NO || 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»