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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
Línea 29: Línea 29:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
| 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
+
| 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  
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| altoRiesgoPension || Ciudad del cliente que compra || cadena || SI || v2.0 / v3.0
+
| altoRiesgoPension || Ciudad del cliente que compra || cadena || SI
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| primerApellido || Dirección física del cliente || cadena || SI || v2.0 / v3.0
+
| primerApellido || Dirección física del cliente || cadena || SI
 
|-
 
|-
| 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
+
| segundoApellido || Tipo de documento según la DIAN<br><small>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| otrosNombres || Número telefónico del cliente || cadena || SI || v2.0 / v3.0
+
| otrosNombres || Número telefónico del cliente || cadena || SI
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| 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
+
| 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
 
|-
 
|-
| 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
+
| 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  
 
|}
 
|}
  

Revisión del 15:39 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
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
tipo Nombre completo del pais de compra
(Por omisión "Colombia")
Obligatorio si documentType=42 (Debe tener algo diferente a "Colombia")
cadena SI/NO
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
altoRiesgoPension Ciudad del cliente que compra cadena SI
tipoDocumento Código del departamento según DIAN
(Si es al extranjero no es necesario)
consultar tabla
cadena SI/NO
numeroDocumento Código del municipio según tabla DIAN
(Si es al extranjero no es necesario)
consultar tabla
cadena SI/NO
primerApellido Dirección física del cliente cadena SI
segundoApellido Tipo de documento según la DIAN
consultar tabla
cadena SI
primerNombre Identificación tributaria del cliente
Si documentType<>"42"-> Debes colocar este campo sin puntos, rayas o dígitos de verificación
cadena SI
otrosNombres Número telefónico del cliente cadena SI
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
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
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
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

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.