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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 30: Línea 30:
 
| 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
 
|-
 
|-
| countryCode || Código ISO de dos letras del país de compra<br><small>(Por omisión "CO") .. en mayúsculas<br/>Obligatorio si documentType=42 (Debe tener algo diferente a "CO")<br>Usa ISO 3166-1 Aplha 2.<br>Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2</small> || cadena || SI/NO || v2.0 / v3.0
+
| countryCode || Código ISO de dos letras del país de compra<br><small>(Por omisión "CO") .. en mayúsculas<br/>CO -> Convierte al proveedor en Residente<br/>Cualquier otro valor lo considera NO Residente<br>Usa ISO 3166-1 Aplha 2.<br>Revisa los códigos aquí: https://es.wikipedia.org/wiki/ISO_3166-2</small> || cadena || SI/NO || v2.0 / v3.0
 
|-
 
|-
 
| countryName || Nombre completo del pais de compra<br><small>(Por omisión "Colombia")<br/>Obligatorio si documentType=42 (Debe tener algo diferente a "Colombia")</small>|| cadena || SI/NO || v2.0 / v3.0
 
| countryName || Nombre completo del pais de compra<br><small>(Por omisión "Colombia")<br/>Obligatorio si documentType=42 (Debe tener algo diferente a "Colombia")</small>|| cadena || SI/NO || v2.0 / v3.0

Revisión del 17:56 21 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",
          "additionalAccountType":"01",
          "name":"Pepito Perez y Compania S.A.",
          "countrySubentity":"11001",
          "addressLine":"Av 25 No. 8-47",
          "documentNumber":"900900651",
          "documentType":"31",
          "telephone":"3112196952",
          "email":"[email protected]"
     }
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
(Por omisión "CO") .. en mayúsculas
CO -> Convierte al proveedor en Residente
Cualquier otro valor lo considera NO Residente
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
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
city Ciudad del proveedor
(Solo requerido para NO residentes)
cadena SI/NO v3.0
countrySubentity Código del municipio según tabla DIAN
(Solo requerido para 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
email correo electronico del proveedor
Es el correo al cual se enviará el documento soporte una vez sea aprobado por la DIAN
Pueden ser varios separados por ";"
El primero se considera el registable en el XML, los demás son únicamente de envio de correo.
cadena SI v3.0
emailStyle Sistema como se accede a los documentos enviados por correo
2->Archivos adjuntos y Asunto homologado DIAN (Por omision)
99->No se envia correo
cadena NO 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.