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
+
| codigo || Código del trabajador en tu sistema<br/><small>Puede ser la cédula o un índice de tu base de datos</small>|| cadena || SI
 
|-
 
|-
−
| 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
+
| tipo || Es el tipo de trabajador según DIAN<br/><small>consultar tabla</small>|| cadena || SI
 
|-
 
|-
−
| 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
+
| subTipo || El Subtipo de trabajador según tabla de la DIAN<br/><small>consultar tabla</small>|| cadena || SI
 
|-
 
|-
−
| altoRiesgoPension || Ciudad del cliente que compra || cadena || SI
+
| altoRiesgoPension || Define si es un trabajador en alto riesgo de pension<br/><small>Puede tener dos valores "verdadero" ó "falso"</small> || 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
+
| tipoDocumento || Tipo de documento según tabla de la DIAN<br><small>consultar tabla</small> || cadena || SI
 
|-
 
|-
−
| 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
+
| numeroDocumento || Documento de identificacion del trabajador<br><small>(Debe ser numerico)<br>consultar tabla</small> || cadena || SI
 
|-
 
|-
−
| primerApellido || Dirección física del cliente || cadena || SI
+
| primerApellido || Primer Apellido del trabajador<br/><small>No puede ir vacio</small> || cadena || SI
 
|-
 
|-
−
| segundoApellido || Tipo de documento según la DIAN<br><small>[[API_LaFactura.co:Tabla_Tipos_Documento|consultar tabla]]</small>|| cadena || SI
+
| segundoApellido || Segundo Apellido del trabajador<br><small>Puede ir vacio</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
+
| primerNombre || Primer Nombre del trabajador<br><small>No puede ir vacio</small>|| cadena || SI
 
|-
 
|-
−
| otrosNombres || Número telefónico del cliente || cadena || SI
+
| otrosNombres || Otros nombres del trabajador<br/><small>Puede ir vacío</small> || 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
+
| salarioIntegral || Se debe informar si el trabajador tiene salario integral<br/><small>Puede tener dos valores "verdadero" ó "falso"</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
+
| tipoContrato || Es el tipo de contrato del trabajador según la tabla de la DIAN<br/><small>consultar tabla</small> || cadena || SI
 
|-
 
|-
−
| 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
+
| sueldo || Sueldo básico del trabajador<br/><small>Numérico con dos decimales<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  
+
| tiempoLaborado || Tiempo que lleva laborando el trabajador en la empresa<br/><small>Numérico con dos decimales<small> || cadena || NO  
 
|}
 
|}
  

Revisión del 15:51 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 Código del trabajador en tu sistema
Puede ser la cédula o un índice de tu base de datos		 cadena SI
tipo Es el tipo de trabajador según DIAN
consultar tabla		 cadena SI
subTipo El Subtipo de trabajador según tabla de la DIAN
consultar tabla		 cadena SI
altoRiesgoPension Define si es un trabajador en alto riesgo de pension
Puede tener dos valores "verdadero" ó "falso"		 cadena SI
tipoDocumento Tipo de documento según tabla de la DIAN
consultar tabla		 cadena SI
numeroDocumento Documento de identificacion del trabajador
(Debe ser numerico)
consultar tabla		 cadena SI
primerApellido Primer Apellido del trabajador
No puede ir vacio		 cadena SI
segundoApellido Segundo Apellido del trabajador
Puede ir vacio		 cadena SI
primerNombre Primer Nombre del trabajador
No puede ir vacio		 cadena SI
otrosNombres Otros nombres del trabajador
Puede ir vacío		 cadena SI
salarioIntegral Se debe informar si el trabajador tiene salario integral
Puede tener dos valores "verdadero" ó "falso"		 cadena SI
tipoContrato Es el tipo de contrato del trabajador según la tabla de la DIAN
consultar tabla		 cadena SI
sueldo Sueldo básico del trabajador
Numérico con dos decimales		 cadena NO
tiempoLaborado Tiempo que lleva laborando el trabajador en la empresa
Numérico con dos decimales		 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.

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Trabajador&oldid=1617»