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 34 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.",
−
          "city":"Bogotá D.C.",
 
−
          "countryEntity":"11",
 
 
           "countrySubentity":"11001",
 
           "countrySubentity":"11001",
 
           "addressLine":"Av 25 No. 8-47",
 
           "addressLine":"Av 25 No. 8-47",
Línea 16: Línea 13:
 
           "documentType":"31",
 
           "documentType":"31",
 
           "telephone":"3112196952",
 
           "telephone":"3112196952",
−
          "email":"[email protected]",
 
−
          "emailStyle":"0"
 
 
       }
 
       }
  
Línea 27: Línea 22:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
! Parámetro !! Descripción !! Tipo !! Obligatorio !! API
 
|-
 
|-
−
| additionalAccountID || Clasificacion del Proveedor<br><small>"1" -> es persona jurídica y asimilada<br>"2" ->es 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
 
|-
 
|-
−
| taxInfo || Datos referentes a las responsabilidades fiscales del proveedor:<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 ";"<br/> [[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 || 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>[[API_LaFactura.co:Tabla_Departamentos|consultar tabla]]</small> || cadena || SI || 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>[[API_LaFactura.co:Tabla_Municipios|consultar tabla]]</small> || cadena || SI || v3.0
+
| city || Ciudad del proveedor|| cadena || SI || v3.0
 
|-
 
|-
−
| addressLine || Dirección física del cliente || 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
 
|-
 
|-
−
| documentType || Tipo de documento según la DIAN<br><small>(Debe contener "31" -> NIT)<br/>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI || v3.0
+
| postalZone || Código Postal del proveedor|| cadena || NO || v3.0
 
|-
 
|-
−
| documentNumber || Identificación tributaria del cliente<br><small>Debes colocar este campo sin puntos, rayas o dígitos de verificación</small>|| cadena || SI || v3.0
+
| addressLine || Dirección física del proveedor || cadena || SI || v3.0
 
|-
 
|-
−
| telephone || Número telefónico 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>)<br/>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| 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
+
| 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>2->Archivos adjuntos y Asunto homologado DIAN <b>(Por omision)</b><br/>99->No se envia correo</small> || cadena || NO || 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»