API LaFactura.co:Trabajador

De API LaFactura.co
Ir a la navegación Ir a la búsqueda

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 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.