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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Objeto:trabajador== Es un objeto usado en nominaIndividual. Permite enviar al sistema, los datos referentes al trabajador. Su uso es obligatorio para la generación de c…»)
 
Línea 33: Línea 33:
 
| name || Nombre de la empresa o persona || 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:<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
+
| codigo || 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
 
|-
 
|-
| 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
+
| tipo || 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
 
|-
 
|-
| 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
+
| subTipo || 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
 
|-
 
|-
| city || Ciudad del cliente que compra || cadena || SI || v2.0 / v3.0
+
| altoRiesgoPension || Ciudad del cliente que compra || cadena || SI || v2.0 / 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
+
| tipoDocumento || 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
 
|-
 
|-
| 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
+
| numeroDocumento || 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
 
|-
 
|-
| addressLine || Dirección física del cliente || cadena || SI || v2.0 / v3.0
+
| primerApellido || Dirección física del cliente || cadena || SI || v2.0 / 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
+
| segundoApellido || Tipo de documento según la DIAN<br><small>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI || v2.0 / 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
+
| primerNombre || 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
 
|-
 
|-
| telephone || Número telefónico del cliente || cadena || SI || v2.0 / v3.0
+
| otrosNombres || Número telefónico del cliente || cadena || SI || v2.0 / 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
+
| salarioIntegral || 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
 
|-
 
|-
| 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
+
| tipoContrato || 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
 +
|-
 +
| sueldo || 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
 +
|-
 +
| tiempoLaborado || 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
 
|}
 
|}
  

Revisión del 15:37 11 jun 2021

Objeto:trabajador

Es un objeto usado en nominaIndividual. Permite enviar al sistema, los datos referentes al trabajador. Su uso es obligatorio para la generación de cualquier nominaIndividual.

Ejemplo
     "trabajador":{
      "codigo":"TR79506693",
      "tipo":"01",
      "subTipo":"00",
      "altoRiesgoPension":"falso",
      "tipoDocumento":"13",
      "numeroDocumento":"79506693",
      "primerApellido":"Perez",
      "segundoApellido":"Perez",
      "primerNombre":"Pepito",
      "otrosNombres":"Alberto",
      "salarioIntegral":"falso",
      "tipoContrato":"2",
      "sueldo":"4000000.00",
      "tiempoLaborado":"360.00"
    }
Campos

Parámetro Descripción Tipo Obligatorio
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
codigo 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
tipo 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
subTipo 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
altoRiesgoPension Ciudad del cliente que compra cadena SI v2.0 / v3.0
tipoDocumento Código del departamento según DIAN
(Si es al extranjero no es necesario)
consultar tabla
cadena SI/NO v2.0 / v3.0
numeroDocumento Código del municipio según tabla DIAN
(Si es al extranjero no es necesario)
consultar tabla
cadena SI/NO v2.0 / v3.0
primerApellido Dirección física del cliente cadena SI v2.0 / v3.0
segundoApellido Tipo de documento según la DIAN
consultar tabla
cadena SI v2.0 / v3.0
primerNombre 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
otrosNombres Número telefónico del cliente cadena SI v2.0 / v3.0
salarioIntegral 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
tipoContrato Sistema como se accede a los documentos enviados por correo
0->Enlace de descarga (Por omision API 2.0) (Convertido a "2" automaticamente en API v3.0)
1->Como archivos adjuntos (Convertido a "2" automaticamente en API v3.0)
2->Acrhivos adjuntos y Asunto homologado DIAN (Por omision API 3.0)
99->No se envia correo
cadena NO v2.0 / v3.0
sueldo Sistema como se accede a los documentos enviados por correo
0->Enlace de descarga (Por omision API 2.0) (Convertido a "2" automaticamente en API v3.0)
1->Como archivos adjuntos (Convertido a "2" automaticamente en API v3.0)
2->Acrhivos adjuntos y Asunto homologado DIAN (Por omision API 3.0)
99->No se envia correo
cadena NO v2.0 / v3.0
tiempoLaborado Sistema como se accede a los documentos enviados por correo
0->Enlace de descarga (Por omision API 2.0) (Convertido a "2" automaticamente en API v3.0)
1->Como archivos adjuntos (Convertido a "2" automaticamente en API v3.0)
2->Acrhivos adjuntos y Asunto homologado DIAN (Por omision API 3.0)
99->No se envia correo
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:

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.