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

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
 
(No se muestran 20 ediciones intermedias del mismo usuario)
Línea 19: Línea 19:
 
       "tipoContrato":"2",
 
       "tipoContrato":"2",
 
       "sueldo":"4000000.00",
 
       "sueldo":"4000000.00",
       "tiempoLaborado":"360.00"
+
       "tiempoLaborado":"360.00",
 +
      "correo":"[email protected]"
 
     }
 
     }
  
Línea 29: Línea 30:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
| additionalAccountID || Tipo de cliente<br><small>"1" -> es persona jurídica<br>"2" ->es persona natural</small> || cadena || SI || v2.0 / v3.0
+
| 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  
 
|-
 
|-
| name || Nombre de la empresa o persona || cadena || SI || v2.0 / v3.0
+
| tipo || Es el tipo de trabajador según DIAN<br/><small>(Por omision -> "01" -> Dependiente)<br/>consultar [[API_LaFactura.co:Tipo_trabajador_nomina|tabla]]</small></small>|| cadena || NO
 
|-
 
|-
| 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
+
| subTipo || El Subtipo de trabajador según tabla de la DIAN<br/><small>(Por omision -> "00" -> No Aplica)<br/>consultar [[API_LaFactura.co:subTipo_trabajador_nomina|tabla]]</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
+
| altoRiesgoPension || Define si es un trabajador en alto riesgo de pension<br/><small>(Por omision -> falso)<br/>Puede tener dos valores "verdadero" ó "falso"</small> || cadena || 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
+
| tipoDocumento || Tipo de documento según tabla de la DIAN<br><small>consultar [[API_LaFactura.co:TipoDocumento_trabajador_nomina|tabla]]</small> || cadena || SI
 
|-
 
|-
| altoRiesgoPension || Ciudad del cliente que compra || cadena || SI || v2.0 / v3.0
+
| numeroDocumento || Documento de identificacion del trabajador<br><small>(Debe ser numerico)</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 || v2.0 / v3.0
+
| primerApellido || Primer Apellido del trabajador<br/><small>No puede ir vacio</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 || v2.0 / v3.0
+
| segundoApellido || Segundo Apellido del trabajador<br><small>Puede ir vacio</small>|| cadena || SI
 
|-
 
|-
| primerApellido || Dirección física del cliente || cadena || SI || v2.0 / v3.0
+
| primerNombre || Primer Nombre 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 || v2.0 / v3.0
+
| otrosNombres || Otros nombres del trabajador<br/><small>Puede ir vacío</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
+
| salarioIntegral || Se debe informar si el trabajador tiene salario integral<br/><small>Puede tener dos valores "verdadero" ó "falso"</small> || cadena || SI
 
|-
 
|-
| otrosNombres || Número telefónico del cliente || cadena || SI || v2.0 / v3.0
+
| tipoContrato || Es el tipo de contrato del trabajador según la tabla de la DIAN<br/><small><small>consultar [[API_LaFactura.co:Tipo_contrato_trabajador_nomina|tabla]]</small></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 || v2.0 / v3.0
+
| sueldo || Sueldo básico del trabajador<br/><small>Numérico con dos decimales<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
+
| tiempoLaborado || Tiempo que lleva laborando el trabajador en la empresa<br/><small>(En días)<br/>Numérico con dos decimales<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 || v2.0 / v3.0
+
| fechaIngreso || Fecha de ingreso a la empresa del empleado<br/><small>Debe solo ser enviada en el momento en que el empleado ingresa a la empresa<br/>(YYYYMMDD) Ejemplo: 20200321</small> || cadena || SI
 
|-
 
|-
| 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
+
| fechaRetiro || Fecha de retiro de la empresa del empleado<br/><small>Debe solo ser enviada en el momento en que el empleado se retira de la empresa<br/>(YYYYMMDD) Ejemplo: 20200321</small> || cadena || NO
 +
|-
 +
| correo || Correo electrónico al que se enviará copia del documento || cadena || SI
 
|}
 
|}
 
<span style="color:#009999"><b>Notas para migrantes de API v2.0 a v3.0:</b></span>
 
----
 
Se agregó taxInfo <b>(MUY IMPORTANTE)</b><br/>
 
Se verifica que el countrySubentity corresponda con el countryEntity (municipio con departamento)<br/>
 
Se cambió el emailStyle por defecto a "2"<br/>
 
Se agregó la posibilidad de enviar a mas de un correo simultáneamente<br/>
 
<br/>
 
----
 
Si no se conocen los datos del cliente se <b>deben</b> 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==
 
==Usado por==
 
Los siguientes recursos:
 
Los siguientes recursos:
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]
+
* [[API_LaFactura.co:Nomina_Individual|Generar Nómina Individual]]
 
Los siguientes objetos:
 
Los siguientes objetos:
* [[API_laFactura.co:invoice|invoice]]
+
* [[API_laFactura.co:nominaIndividual|nominaIndividual]]
  
 
==Temas complementarios==
 
==Temas complementarios==
* [[API_LaFactura.co:Facturacion|Facturación]]
+
* [[API_LaFactura.co:Nomina|Nomina]]
  
 
==Enlaces==
 
==Enlaces==

Revisión actual del 16:39 26 sep 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",
      "correo":"[email protected]"
    }
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
(Por omision -> "01" -> Dependiente)
consultar tabla
cadena NO
subTipo El Subtipo de trabajador según tabla de la DIAN
(Por omision -> "00" -> No Aplica)
consultar tabla
cadena NO
altoRiesgoPension Define si es un trabajador en alto riesgo de pension
(Por omision -> falso)
Puede tener dos valores "verdadero" ó "falso"
cadena NO
tipoDocumento Tipo de documento según tabla de la DIAN
consultar tabla
cadena SI
numeroDocumento Documento de identificacion del trabajador
(Debe ser numerico)
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 SI
tiempoLaborado Tiempo que lleva laborando el trabajador en la empresa
(En días)
Numérico con dos decimales
cadena SI
fechaIngreso Fecha de ingreso a la empresa del empleado
Debe solo ser enviada en el momento en que el empleado ingresa a la empresa
(YYYYMMDD) Ejemplo: 20200321
cadena SI
fechaRetiro Fecha de retiro de la empresa del empleado
Debe solo ser enviada en el momento en que el empleado se retira de la empresa
(YYYYMMDD) Ejemplo: 20200321
cadena NO
correo Correo electrónico al que se enviará copia del documento cadena SI

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.