API LaFactura.co:Trabajador
Sumario
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
- LaFactura.co: https://lafactura.co
- GitHub: https://github.com/FacturacionElectronicaColombia/lafactura.co
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.