{"openapi":"3.1.0","info":{"title":"AdapterDian","version":"1.8.0","description":"Adaptador de facturacion electronica DIAN de Piensa IT. Contrato neutral al proveedor: los consumidores hablan de conceptos de negocio y el adaptador traduce al proveedor vigente.\n\n**Idempotencia:** todo POST que produce un documento exige la cabecera `Idempotency-Key`. Un reintento con la misma clave devuelve el documento original en vez de emitir uno nuevo.\n\n**Asincronia:** la emision responde `202 Accepted` con un `transaction_id`. El estado final se consulta en `GET /invoices/v1/sales-invoices/{id}`.","contact":{"name":"Piensa IT"}},"servers":[{"url":"/functions/v1","description":"Este despliegue"}],"security":[{"ApiKeyAuth":[]}],"tags":[{"name":"Emision","description":"Facturas de venta y documentos equivalentes"},{"name":"Nomina","description":"Nomina electronica y sus notas de ajuste"},{"name":"Recepcion","description":"Facturas de compra y eventos Radian"},{"name":"Operacion","description":"Infraestructura: salud del servicio"}],"paths":{"/invoices/v1/sales-invoices":{"post":{"tags":["Emision"],"operationId":"issueSalesInvoice","summary":"Emitir una factura electronica de venta","description":"Valida las reglas de emision, calcula totales y ajuste de redondeo, y encola el documento. Responde antes de que el proveedor conteste: el estado final se consulta aparte.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSalesInvoice"},"example":{"customer":{"identification_document_code":"31","identification":"123456789","legal_organization":"legal_entity","company":"Alan company name","trade_name":"Alan trade name","address":"calle 1 # 1-1","email":"alan.company@email.com","phone":"1234567890","tribute_code":"ZZ","country_code":"CO","responsibilities":["R-99-PN"],"municipality_code":"68679"},"items":[{"code_reference":"PROD-000A","name":"Producto A","quantity":"1.00","price":"10000.00","discount_rate":"0.00","unit_measure_code":"94","standard_code":"999","taxes":[{"code":"01","rate":"19.00"}]},{"code_reference":"PROD-000B","name":"Producto B","quantity":"3.00","price":"20000.00","discount_rate":"0.00","unit_measure_code":"94","standard_code":"999","taxes":[{"code":"01","rate":"19.00"}]}],"payment_details":[{"payment_form":"cash","payment_method_code":"42","reference_code":"pago-001","amount":"83300.00"}],"observation":"Observacion de prueba"}}}},"responses":{"202":{"description":"factura aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Emision"],"operationId":"listSalesInvoices","summary":"Listar las facturas emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/sales-invoices/{id}":{"get":{"tags":["Emision"],"operationId":"getSalesInvoice","summary":"Consultar el estado de una factura electronica de venta","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Emision"],"operationId":"discardSalesInvoice","summary":"Descartar una factura electronica de venta sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/sales-invoices/{id}/email":{"post":{"tags":["Emision"],"operationId":"emailSalesInvoice","summary":"Reenviar una factura electronica de venta por correo","description":"Envia el documento, con su representacion grafica, a la direccion indicada.\n\nEl destinatario es obligatorio y NO se deduce del cliente del documento: el caso que motiva este endpoint es precisamente reenviar a otra direccion —el contador, un segundo contacto, la que se escribio mal la primera vez—.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"202":{"description":"El proveedor acepto el envio"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El correo o el identificador no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/sales-invoices/{id}/{format}":{"get":{"tags":["Emision"],"operationId":"downloadInvoice","summary":"Descargar la representacion de una factura electronica de venta","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nLa respuesta del formato `zip` trae ademas la cabecera `X-Email-Subject` con el asunto del correo, percent-encoded.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento · attached-xml incluye la respuesta de la autoridad · zip es el paquete que iria por correo","schema":{"type":"string","enum":["pdf","xml","attached-xml","zip"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/sales-invoices/{id}/events":{"get":{"tags":["Emision"],"operationId":"getSalesInvoiceEvents","summary":"Consultar los eventos Radian de una factura electronica de venta","description":"La otra cara de `POST /receptions/v1/received-documents/{id}/events`: alli respondemos por lo que nos emitieron, aqui vemos como han respondido a lo nuestro. Sin esto el emisor no sabe si su cliente acuso, reclamo o dejo vencer el plazo de tres dias habiles.\n\nSolo existe para facturas: la autoridad no registra recorrido Radian sobre una nota ni sobre un documento soporte.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Eventos registrados sobre el documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentEventList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo entregar los eventos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/credit-notes":{"post":{"tags":["Emision"],"operationId":"issueCreditNote","summary":"Emitir una nota credito electronica","description":"Corrige una factura ya emitida. Conceptos validos: 1 devolucion parcial · 2 anulacion · 3 rebaja o descuento · 4 ajuste de precio · 5 descuento por pronto pago · 6 descuento por volumen.\n\nOmitir `bill_number` declara una nota SIN referencia a una factura; en ese caso `billing_period` pasa a ser obligatorio.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCreditNote"}}}},"responses":{"202":{"description":"nota credito aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Emision"],"operationId":"listCreditNotes","summary":"Listar las notas credito emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/credit-notes/{id}":{"get":{"tags":["Emision"],"operationId":"getCreditNote","summary":"Consultar el estado de una nota credito electronica","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Emision"],"operationId":"discardCreditNote","summary":"Descartar una nota credito electronica sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/credit-notes/{id}/email":{"post":{"tags":["Emision"],"operationId":"emailCreditNote","summary":"Reenviar una nota credito electronica por correo","description":"Envia el documento, con su representacion grafica, a la direccion indicada.\n\nEl destinatario es obligatorio y NO se deduce del cliente del documento: el caso que motiva este endpoint es precisamente reenviar a otra direccion —el contador, un segundo contacto, la que se escribio mal la primera vez—.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"202":{"description":"El proveedor acepto el envio"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El correo o el identificador no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/credit-notes/{id}/{format}":{"get":{"tags":["Emision"],"operationId":"downloadCreditNote","summary":"Descargar la representacion de una nota credito electronica","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nLa respuesta del formato `zip` trae ademas la cabecera `X-Email-Subject` con el asunto del correo, percent-encoded.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento · attached-xml incluye la respuesta de la autoridad · zip es el paquete que iria por correo","schema":{"type":"string","enum":["pdf","xml","attached-xml","zip"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/debit-notes":{"post":{"tags":["Emision"],"operationId":"issueDebitNote","summary":"Emitir una nota debito electronica","description":"Corrige una factura ya emitida. Conceptos validos: 1 intereses · 2 gastos por cobrar · 3 cambio del valor · 4 otros.\n\nOmitir `bill_number` declara una nota SIN referencia a una factura; en ese caso `billing_period` pasa a ser obligatorio.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDebitNote"}}}},"responses":{"202":{"description":"nota debito aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Emision"],"operationId":"listDebitNotes","summary":"Listar las notas debito emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/debit-notes/{id}":{"get":{"tags":["Emision"],"operationId":"getDebitNote","summary":"Consultar el estado de una nota debito electronica","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Emision"],"operationId":"discardDebitNote","summary":"Descartar una nota debito electronica sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/debit-notes/{id}/email":{"post":{"tags":["Emision"],"operationId":"emailDebitNote","summary":"Reenviar una nota debito electronica por correo","description":"Envia el documento, con su representacion grafica, a la direccion indicada.\n\nEl destinatario es obligatorio y NO se deduce del cliente del documento: el caso que motiva este endpoint es precisamente reenviar a otra direccion —el contador, un segundo contacto, la que se escribio mal la primera vez—.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"202":{"description":"El proveedor acepto el envio"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El correo o el identificador no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/debit-notes/{id}/{format}":{"get":{"tags":["Emision"],"operationId":"downloadDebitNote","summary":"Descargar la representacion de una nota debito electronica","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nLa respuesta del formato `zip` trae ademas la cabecera `X-Email-Subject` con el asunto del correo, percent-encoded.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento · attached-xml incluye la respuesta de la autoridad · zip es el paquete que iria por correo","schema":{"type":"string","enum":["pdf","xml","attached-xml","zip"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/support-documents":{"post":{"tags":["Emision"],"operationId":"issueSupportDocument","summary":"Emitir un documento soporte","description":"Registra ante la DIAN una compra a alguien que NO esta obligado a expedir factura —un profesional independiente, un pequeno productor—. Es lo que sustenta la deduccion del costo.\n\nLa contraparte es `provider`, no `customer`, y no es el mismo objeto con otro nombre: exige `names` y `address` (opcionales en una venta) y no lleva responsabilidades fiscales ni codigo de tributo, porque quien no factura no las tiene.\n\nEl tipo de identificacion sale de un catalogo PROPIO y mas corto: **no admite cedula de ciudadania (13)**. Es el error mas probable de quien reutiliza el maestro de clientes para registrar proveedores.\n\nEl unico impuesto admitido en la linea es el `01` (IVA).","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSupportDocument"},"example":{"provider":{"identification_document_code":"31","identification":"901234567","dv":"7","names":"Pedro Perez Servicios","address":"calle 4 # 12-30","country_code":"CO","municipality_code":"68679","email":"pedro.perez@email.com","phone":"3001234567"},"items":[{"code_reference":"SERV-001","name":"Servicio de mantenimiento","quantity":"1.00","price":"1000000.00","discount_rate":"0.00","unit_measure_code":"94","standard_code":"999","withholding_taxes":[{"code":"06","rate":"4.00"}],"taxes":[{"code":"01","rate":"19.00"}]}],"payment_details":[{"payment_form":"cash","payment_method_code":"42","reference_code":"pago-ds-001","amount":"1190000.00"}],"observation":"Mantenimiento preventivo de agosto"}}}},"responses":{"202":{"description":"documento soporte aceptado y encolado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Emision"],"operationId":"listSupportDocuments","summary":"Listar los documentos soporte emitidos","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/support-documents/{id}":{"get":{"tags":["Emision"],"operationId":"getSupportDocument","summary":"Consultar el estado de un documento soporte","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Emision"],"operationId":"discardSupportDocument","summary":"Descartar un documento soporte sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/support-documents/{id}/email":{"post":{"tags":["Emision"],"operationId":"emailSupportDocument","summary":"Reenviar un documento soporte por correo","description":"Envia el documento, con su representacion grafica, a la direccion indicada.\n\nEl destinatario es obligatorio y NO se deduce del cliente del documento: el caso que motiva este endpoint es precisamente reenviar a otra direccion —el contador, un segundo contacto, la que se escribio mal la primera vez—.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"202":{"description":"El proveedor acepto el envio"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El correo o el identificador no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/support-documents/{id}/{format}":{"get":{"tags":["Emision"],"operationId":"downloadSupportDocument","summary":"Descargar la representacion de un documento soporte","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nEste tipo de documento solo publica `pdf` y `xml`: no tiene AttachedDocument ni contenido de correo.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento","schema":{"type":"string","enum":["pdf","xml"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/adjustment-notes":{"post":{"tags":["Emision"],"operationId":"issueAdjustmentNote","summary":"Emitir una nota de ajuste","description":"Corrige un documento soporte ya emitido. `support_document_number` es OBLIGATORIO: una nota credito sin factura es un caso que la DIAN contempla, pero una nota de ajuste sin documento al que ajustar no ajusta nada.\n\nConceptos validos: 1 devolucion parcial · 2 anulacion del documento soporte · 3 rebaja o descuento · 4 ajuste de precio · 5 otros. **No es el catalogo de la nota credito**: aqui el `5` es \"otros\" y alli es \"descuento por pronto pago\".\n\nNumera contra su PROPIA resolucion, distinta de la del documento soporte.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdjustmentNote"}}}},"responses":{"202":{"description":"nota de ajuste aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Emision"],"operationId":"listAdjustmentNotes","summary":"Listar las notas de ajuste emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/adjustment-notes/{id}":{"get":{"tags":["Emision"],"operationId":"getAdjustmentNote","summary":"Consultar el estado de una nota de ajuste","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Emision"],"operationId":"discardAdjustmentNote","summary":"Descartar una nota de ajuste sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/adjustment-notes/{id}/email":{"post":{"tags":["Emision"],"operationId":"emailAdjustmentNote","summary":"Reenviar una nota de ajuste por correo","description":"Envia el documento, con su representacion grafica, a la direccion indicada.\n\nEl destinatario es obligatorio y NO se deduce del cliente del documento: el caso que motiva este endpoint es precisamente reenviar a otra direccion —el contador, un segundo contacto, la que se escribio mal la primera vez—.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SendEmail"}}}},"responses":{"202":{"description":"El proveedor acepto el envio"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El correo o el identificador no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/adjustment-notes/{id}/{format}":{"get":{"tags":["Emision"],"operationId":"downloadAdjustmentNote","summary":"Descargar la representacion de una nota de ajuste","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nEste tipo de documento solo publica `pdf` y `xml`: no tiene AttachedDocument ni contenido de correo.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento","schema":{"type":"string","enum":["pdf","xml"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/payrolls":{"post":{"tags":["Nomina"],"operationId":"issuePayroll","summary":"Emitir una nomina electronica","description":"Reporta ante la DIAN la nomina de un trabajador para un periodo.\n\nLos devengados y las deducciones se declaran con **nombres de negocio** (`basic_salary`, `severance`, `health`, `withholding_tax`...), no con las abreviaturas del proveedor tecnologico. Los 42 conceptos del catalogo comparten una sola forma —importe, y segun el concepto cantidad, porcentaje o rango de fechas—; cual admite cada uno y si acepta uno o varios lo valida el adaptador.\n\n`accruals.basic_salary` es obligatorio, y `deductions.health` y `deductions.pension` lo son por ley.\n\n**No hay representacion grafica:** la nomina solo publica `xml`.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayroll"},"example":{"settlement_period":{"month":8,"year":2026,"payroll_period_code":"4"},"payment":{"payment_method_code":"47","bank_name":"Bancolombia","account_type":"AHORROS","account_number":"12345678901","payment_date":"2026-08-31"},"worker":{"identification_document_code":"13","identification_number":"1020304050","first_name":"Laura","first_surname":"Restrepo","second_surname":"Gomez","address":"calle 45 # 12-30","country_code":"CO","municipality_code":"11001","has_integral_salary":false,"has_high_risk":false,"worker_type_code":"01","worker_subtype":"00","contract_type":"1","employee_code":"EMP-0042","salary":"3000000.00","entry_date":"2024-02-01","days_worked":30},"accruals":{"basic_salary":{"amount":"3000000.00"},"transport_allowance":[{"amount":"162000.00"}],"overtime_and_surcharges":[{"type_code":"1","quantity":4,"percentage":"25.00","amount":"50000.00","start_date":"2026-08-12","end_date":"2026-08-12"}]},"deductions":{"health":{"percentage":"4.00","amount":"120000.00"},"pension":{"percentage":"4.00","amount":"120000.00"},"withholding_tax":{"amount":"85000.00"}}}}}},"responses":{"202":{"description":"nomina aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Nomina"],"operationId":"listPayrolls","summary":"Listar las nominas emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/payrolls/{id}":{"get":{"tags":["Nomina"],"operationId":"getPayroll","summary":"Consultar el estado de una nomina electronica","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Nomina"],"operationId":"discardPayroll","summary":"Descartar una nomina electronica sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/payrolls/{id}/{format}":{"get":{"tags":["Nomina"],"operationId":"downloadPayroll","summary":"Descargar la representacion de una nomina electronica","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nEste tipo de documento solo publica `pdf` y `xml`: no tiene AttachedDocument ni contenido de correo.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento","schema":{"type":"string","enum":["xml"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/adjustment-payrolls":{"post":{"tags":["Nomina"],"operationId":"issuePayrollAdjustment","summary":"Emitir una nota de ajuste de nomina","description":"**Elimina** ante la DIAN una nomina ya emitida. No la corrige: la anula.\n\nNo se lea por analogia con la nota credito, que corrige una factura dejando ambas en pie. Por eso su cuerpo son dos campos y no una nomina entera: no hay nada que recalcular.\n\nNumera contra un rango PROPIO, distinto del de nominas.\n\nDistinto de `DELETE /payrolls/v1/payrolls/{id}`, que descarta una nomina que la DIAN nunca llego a validar.","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8},"description":"Clave unica de la operacion. Un reintento con la misma clave no emite dos veces."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePayrollAdjustment"}}}},"responses":{"202":{"description":"nota de ajuste de nomina aceptada y encolada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Accepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"La clave de idempotencia ya se uso con otro contenido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El documento no cumple las reglas de emision","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Nomina"],"operationId":"listPayrollAdjustments","summary":"Listar las notas de ajuste de nomina emitidas","description":"Lo que ESTE tenant ha emitido de este tipo, mas reciente primero.\n\nSe sirve desde la base del adaptador y no del listado del proveedor tecnologico, y es una decision de aislamiento: la credencial del proveedor es una sola para todo el servicio, asi que su listado devuelve los documentos de todos los clientes. El precio es que no aparecen los documentos emitidos fuera de este adaptador.","parameters":[{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]}},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero DIAN exacto"},{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1}},{"name":"per_page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100},"description":"Por defecto 25, tope 100"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Listado paginado","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"Los filtros no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/adjustment-payrolls/{id}":{"get":{"tags":["Nomina"],"operationId":"getPayrollAdjustment","summary":"Consultar el estado de una nota de ajuste de nomina","description":"Un documento en estado `validated` puede traer `warnings`: son notificaciones de la autoridad tributaria que no implican rechazo, pero si observaciones sobre datos maestros.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Estado del documento","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"delete":{"tags":["Nomina"],"operationId":"discardPayrollAdjustment","summary":"Descartar una nota de ajuste de nomina sin validar","description":"Solo para documentos que la DIAN **no** ha validado. Es la salida documentada del conflicto \"hay un documento pendiente por enviar\": se descarta y se vuelve a crear corregido.\n\nUn documento ya validado devuelve 409 y no se toca. Un documento fiscal aceptado por la autoridad existe para siempre: lo que lo corrige es una nota, no un borrado.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documento descartado"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento ya fue validado por la DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/adjustment-payrolls/{id}/{format}":{"get":{"tags":["Nomina"],"operationId":"downloadPayrollAdjustment","summary":"Descargar la representacion de una nota de ajuste de nomina","description":"Solo disponible cuando el documento ya tiene numero DIAN. Antes de eso responde 409 nombrando el estado actual: el documento existe, pero todavia no ante la autoridad.\n\nEste tipo de documento solo publica `pdf` y `xml`: no tiene AttachedDocument ni contenido de correo.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"format","in":"path","required":true,"description":"pdf y xml son el documento","schema":{"type":"string","enum":["xml"]}}],"responses":{"200":{"description":"Contenido binario del documento","content":{"application/octet-stream":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Documento no encontrado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"El documento aun no tiene numero DIAN","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El identificador no es un UUID, o el formato no existe para este tipo","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no devolvio la representacion","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/invoices/v1/numbering-ranges":{"get":{"tags":["Emision"],"operationId":"listNumberingRanges","summary":"Listar los rangos de numeracion de facturacion","description":"Los prefijos que el emisor tiene autorizados por la DIAN para facturacion. Sin este listado, `numbering_prefix` es un campo que hay que rellenar a ciegas: la unica forma de saber que prefijos existen era entrar al panel del proveedor.\n\nCon mas de una resolucion activa del mismo tipo, declarar el prefijo correcto es lo unico que evita el rechazo del documento.\n\n`kind` viene ya traducido al vocabulario de este contrato; es `null` cuando el rango es de un tipo que este servicio todavia no emite.","parameters":[{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rangos autorizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberingRangeList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo entregar los rangos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/payrolls/v1/numbering-ranges":{"get":{"tags":["Nomina"],"operationId":"listPayrollNumberingRanges","summary":"Listar los rangos de numeracion de nomina","description":"Los prefijos que el emisor tiene autorizados por la DIAN para nomina. Sin este listado, `numbering_prefix` es un campo que hay que rellenar a ciegas: la unica forma de saber que prefijos existen era entrar al panel del proveedor.\n\nCon mas de una resolucion activa del mismo tipo, declarar el prefijo correcto es lo unico que evita el rechazo del documento.\n\n`kind` viene ya traducido al vocabulario de este contrato; es `null` cuando el rango es de un tipo que este servicio todavia no emite.","parameters":[{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rangos autorizados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NumberingRangeList"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo entregar los rangos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/receptions/v1/received-documents":{"post":{"tags":["Recepcion"],"operationId":"uploadReceivedDocument","summary":"Incorporar a la bandeja una factura que nos emitieron","description":"La bandeja solo muestra lo que el proveedor tecnologico ya recibio de la DIAN, y un documento puede llegarnos por otra via —el propio emisor nos lo manda— antes o en vez de eso.\n\nSe identifica por su CUFE, que es el unico dato que la autoridad necesita para localizarlo.","parameters":[{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadReceived"}}}},"responses":{"202":{"description":"El proveedor acepto la carga"},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El CUFE no es valido","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo cargar el documento","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}},"get":{"tags":["Recepcion"],"operationId":"listReceivedDocuments","summary":"Listar los documentos que terceros nos han emitido","description":"La bandeja de entrada de compras. Los documentos NO se persisten aqui: se consultan al proveedor tecnologico en cada llamada, que es quien los recibe de la DIAN.\n\nEl `id` de cada elemento es el que exige `POST /receptions/v1/received-documents/{id}/events`.\n\nEl rango de fechas es inclusivo y se expresa en dias de calendario. Cuando el proveedor vigente no sabe filtrar por rango, el adaptador recorre su paginacion y filtra; por eso un rango amplio tarda mas que un dia suelto.","parameters":[{"name":"issued_from","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Fecha de emision minima, inclusive (YYYY-MM-DD)"},{"name":"issued_to","in":"query","required":false,"schema":{"type":"string","format":"date"},"description":"Fecha de emision maxima, inclusive (YYYY-MM-DD)"},{"name":"issuer_tax_id","in":"query","required":false,"schema":{"type":"string"},"description":"NIT del emisor. Se admite con puntos y con digito de verificacion: se normaliza."},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Numero exacto del documento"},{"name":"cufe","in":"query","required":false,"schema":{"type":"string"},"description":"CUFE exacto del documento"},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1},"description":"Pagina del listado del proveedor. Declararla desactiva el recorrido automatico de paginas: se devuelve solo esa."},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Documentos recibidos. Una bandeja vacia es una lista vacia, no un error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceivedDocumentList"},"example":{"data":[{"id":"a2564647-6eaf-4cfc-9b2f-ba32113e43e2","number":"SETP990036246","cufe":"75119c4a0221e8a31f5b8de4ad2caedd4b60f1794f3e005987ec2c9fba25215c","kind":"sales_invoice","issue_date":"2026-07-24","received_at":"2026-07-24T17:31:39.000Z","issuer":{"tax_id":"901234567","name":"Proveedor de Ejemplo SAS"},"totals":{"subtotal":null,"tax_amount":null,"total":"50000.00"},"acknowledgement_state":null}],"count":1}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El rango de fechas o la pagina no son validos","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo entregar el listado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/receptions/v1/received-documents/{id}/events":{"post":{"tags":["Recepcion"],"operationId":"emitReceptionEvent","summary":"Emitir un evento Radian sobre una factura recibida","description":"Responder ante la DIAN por una factura que un tercero nos emitio. **Tiene plazo: tres dias habiles.** Vencido, la factura se entiende aceptada tacitamente y ya no se puede objetar.\n\nEl orden es obligatorio: acuse -> recibo del bien -> aceptacion o reclamo. Ese orden lo hace cumplir el proveedor tecnologico, que es el unico que conoce el estado actual del documento; una transicion invalida vuelve como 409.\n\nUn reclamo SIN `claim_concept_code` se rechaza con 422 antes de salir a la red: sin causal la DIAN no registra la objecion.\n\nEl `id` es el del documento en el proveedor tecnologico, tal como lo devuelve `GET /receptions/v1/received-documents`. No es un UUID de este adaptador: aqui no se persiste nada de recepcion.\n\nLos codigos DIAN 030-034 son detalle del proveedor y no aparecen en este contrato.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Identificador del documento en el proveedor tecnologico"},{"name":"X-Correlation-Id","in":"header","required":false,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceptionEvent"},"example":{"type":"claim","actor":{"identification_document_code":"31","identification":"901724254","first_name":"Laura","last_name":"Restrepo","job_title":"Recepcion de facturas","organization_department":"Compras"},"claim_concept_code":"02"}}}},"responses":{"202":{"description":"Evento registrado por el proveedor","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReceptionEventAccepted"}}}},"401":{"description":"Credencial ausente o invalida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"La credencial no tiene el permiso invoices:write","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"409":{"description":"Transicion de estado no permitida","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"422":{"description":"El evento no es valido: reclamo sin causal, actor incompleto o id mal formado","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"El proveedor no pudo registrar el evento","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/health":{"get":{"tags":["Operacion"],"operationId":"health","summary":"Estado del servicio","security":[],"responses":{"200":{"description":"El servicio responde"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"http","scheme":"bearer","description":"API Key emitida por Piensa IT para cada servicio consumidor."}},"schemas":{"CreateSalesInvoice":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"customer":{"type":"object","properties":{"identification_document_code":{"type":"string","minLength":1},"identification":{"type":"string","pattern":"^\\d{5,15}$"},"dv":{"type":"string","pattern":"^\\d$"},"legal_organization":{"type":"string","enum":["legal_entity","natural_person"]},"tribute_code":{"default":"ZZ","type":"string"},"responsibilities":{"default":["R-99-PN"],"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"company":{"type":"string"},"trade_name":{"type":"string"},"names":{"type":"string"},"address":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"},"country_code":{"default":"CO","type":"string"},"municipality_code":{"type":"string"}},"required":["identification_document_code","identification","legal_organization"]},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code_reference":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"quantity":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"price":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$","description":"Precio unitario sin impuestos ni descuentos"},"discount_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"discount_amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"unit_measure_code":{"type":"string","minLength":1},"standard_code":{"type":"string","minLength":1},"note":{"type":"string","maxLength":500},"taxes":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1,"description":"Codigo del impuesto (catalogo DIAN)"},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"is_excluded":{"type":"boolean"}},"required":["code","rate"],"description":"Impuesto aplicado al item"}},"withholding_taxes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"}},"required":["code","rate"]}}},"required":["code_reference","name","quantity","price","unit_measure_code","standard_code","taxes"]}},"payment_details":{"minItems":1,"type":"array","items":{"type":"object","properties":{"payment_form":{"type":"string","enum":["cash","credit"]},"payment_method_code":{"type":"string","minLength":1},"reference_code":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_form","payment_method_code","amount"]}},"numbering_prefix":{"type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":250},"send_email":{"type":"boolean"},"billing_period":{"type":"object","properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["start_date","end_date"]},"order_reference":{"type":"object","properties":{"reference_code":{"type":"string","minLength":1},"issue_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["reference_code","issue_date"]}},"required":["customer","items","payment_details"],"description":"Factura electronica de venta estandar"},"CreateCreditNote":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"customer":{"type":"object","properties":{"identification_document_code":{"type":"string","minLength":1},"identification":{"type":"string","pattern":"^\\d{5,15}$"},"dv":{"type":"string","pattern":"^\\d$"},"legal_organization":{"type":"string","enum":["legal_entity","natural_person"]},"tribute_code":{"default":"ZZ","type":"string"},"responsibilities":{"default":["R-99-PN"],"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"company":{"type":"string"},"trade_name":{"type":"string"},"names":{"type":"string"},"address":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"},"country_code":{"default":"CO","type":"string"},"municipality_code":{"type":"string"}},"required":["identification_document_code","identification","legal_organization"]},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code_reference":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"quantity":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"price":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$","description":"Precio unitario sin impuestos ni descuentos"},"discount_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"discount_amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"unit_measure_code":{"type":"string","minLength":1},"standard_code":{"type":"string","minLength":1},"note":{"type":"string","maxLength":500},"taxes":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1,"description":"Codigo del impuesto (catalogo DIAN)"},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"is_excluded":{"type":"boolean"}},"required":["code","rate"],"description":"Impuesto aplicado al item"}},"withholding_taxes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"}},"required":["code","rate"]}}},"required":["code_reference","name","quantity","price","unit_measure_code","standard_code","taxes"]}},"payment_details":{"minItems":1,"type":"array","items":{"type":"object","properties":{"payment_form":{"type":"string","enum":["cash","credit"]},"payment_method_code":{"type":"string","minLength":1},"reference_code":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_form","payment_method_code","amount"]}},"numbering_prefix":{"type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":250},"send_email":{"type":"boolean"},"billing_period":{"type":"object","properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["start_date","end_date"]},"order_reference":{"type":"object","properties":{"reference_code":{"type":"string","minLength":1},"issue_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["reference_code","issue_date"]},"bill_number":{"description":"Numero de la factura corregida. Omitirlo declara una nota sin referencia.","type":"string","minLength":1},"correction_concept_code":{"type":"string","enum":["1","2","3","4","5","6"],"description":"1 devolucion parcial · 2 anulacion · 3 rebaja o descuento · 4 ajuste de precio · 5 descuento por pronto pago · 6 descuento por volumen"}},"required":["customer","items","payment_details","correction_concept_code"],"description":"Nota credito electronica"},"CreateDebitNote":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"customer":{"type":"object","properties":{"identification_document_code":{"type":"string","minLength":1},"identification":{"type":"string","pattern":"^\\d{5,15}$"},"dv":{"type":"string","pattern":"^\\d$"},"legal_organization":{"type":"string","enum":["legal_entity","natural_person"]},"tribute_code":{"default":"ZZ","type":"string"},"responsibilities":{"default":["R-99-PN"],"minItems":1,"type":"array","items":{"type":"string","minLength":1}},"company":{"type":"string"},"trade_name":{"type":"string"},"names":{"type":"string"},"address":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"},"country_code":{"default":"CO","type":"string"},"municipality_code":{"type":"string"}},"required":["identification_document_code","identification","legal_organization"]},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code_reference":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"quantity":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"price":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$","description":"Precio unitario sin impuestos ni descuentos"},"discount_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"discount_amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"unit_measure_code":{"type":"string","minLength":1},"standard_code":{"type":"string","minLength":1},"note":{"type":"string","maxLength":500},"taxes":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1,"description":"Codigo del impuesto (catalogo DIAN)"},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"is_excluded":{"type":"boolean"}},"required":["code","rate"],"description":"Impuesto aplicado al item"}},"withholding_taxes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"}},"required":["code","rate"]}}},"required":["code_reference","name","quantity","price","unit_measure_code","standard_code","taxes"]}},"payment_details":{"minItems":1,"type":"array","items":{"type":"object","properties":{"payment_form":{"type":"string","enum":["cash","credit"]},"payment_method_code":{"type":"string","minLength":1},"reference_code":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_form","payment_method_code","amount"]}},"numbering_prefix":{"type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":250},"send_email":{"type":"boolean"},"billing_period":{"type":"object","properties":{"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["start_date","end_date"]},"order_reference":{"type":"object","properties":{"reference_code":{"type":"string","minLength":1},"issue_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["reference_code","issue_date"]},"bill_number":{"description":"Numero de la factura corregida. Omitirlo declara una nota sin referencia.","type":"string","minLength":1},"correction_concept_code":{"type":"string","enum":["1","2","3","4"],"description":"1 intereses · 2 gastos por cobrar · 3 cambio del valor · 4 otros"}},"required":["customer","items","payment_details","correction_concept_code"],"description":"Nota debito electronica"},"CreateSupportDocument":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"provider":{"type":"object","properties":{"identification_document_code":{"type":"string","enum":["21","22","31","41","42","47","50"],"description":"Catalogo PROPIO del documento soporte, mas corto que el de la factura: 21 tarjeta de extranjeria · 22 cedula de extranjeria · 31 NIT · 41 pasaporte · 42 documento extranjero · 47 PEP · 50 NIT de otro pais. No admite cedula de ciudadania."},"identification":{"type":"string","pattern":"^\\d{5,15}$"},"dv":{"description":"Si se omite, el proveedor tecnologico lo calcula.","type":"string","pattern":"^\\d$"},"trade_name":{"type":"string"},"names":{"type":"string","minLength":1,"description":"Obligatorio, a diferencia de la factura de venta"},"address":{"type":"string","minLength":1,"description":"Obligatoria, a diferencia de la factura de venta"},"country_code":{"default":"CO","type":"string"},"municipality_code":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"}},"required":["identification_document_code","identification","names","address"],"description":"Proveedor no obligado a expedir factura de venta"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code_reference":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"quantity":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"price":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$","description":"Precio unitario sin impuestos ni descuentos"},"discount_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"discount_amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"unit_measure_code":{"type":"string","minLength":1},"standard_code":{"type":"string","minLength":1},"note":{"type":"string","maxLength":500},"taxes":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","const":"01"},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"is_excluded":{"type":"boolean"}},"required":["code","rate"]}},"withholding_taxes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"}},"required":["code","rate"]}}},"required":["code_reference","name","quantity","price","unit_measure_code","standard_code","taxes"]}},"payment_details":{"minItems":1,"type":"array","items":{"type":"object","properties":{"payment_form":{"type":"string","enum":["cash","credit"]},"payment_method_code":{"type":"string","minLength":1},"reference_code":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_form","payment_method_code","amount"]}},"establishment":{"type":"object","properties":{"name":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"phone_number":{"type":"string","minLength":1},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"municipality_code":{"type":"string","minLength":1}},"required":["name","address","phone_number","email","municipality_code"],"description":"Establecimiento que realiza la compra. Va entero o no va."},"numbering_prefix":{"description":"Prefijo de la resolucion autorizada. Necesario solo con mas de un rango activo.","type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":500},"created_time":{"description":"Hora de creacion. La fecha la pone el proveedor tecnologico.","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"}},"required":["provider","items","payment_details"],"description":"Documento soporte en adquisiciones a no obligados a facturar"},"CreateAdjustmentNote":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"provider":{"type":"object","properties":{"identification_document_code":{"type":"string","enum":["21","22","31","41","42","47","50"],"description":"Catalogo PROPIO del documento soporte, mas corto que el de la factura: 21 tarjeta de extranjeria · 22 cedula de extranjeria · 31 NIT · 41 pasaporte · 42 documento extranjero · 47 PEP · 50 NIT de otro pais. No admite cedula de ciudadania."},"identification":{"type":"string","pattern":"^\\d{5,15}$"},"dv":{"description":"Si se omite, el proveedor tecnologico lo calcula.","type":"string","pattern":"^\\d$"},"trade_name":{"type":"string"},"names":{"type":"string","minLength":1,"description":"Obligatorio, a diferencia de la factura de venta"},"address":{"type":"string","minLength":1,"description":"Obligatoria, a diferencia de la factura de venta"},"country_code":{"default":"CO","type":"string"},"municipality_code":{"type":"string"},"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"},"phone":{"type":"string"}},"required":["identification_document_code","identification","names","address"],"description":"Proveedor no obligado a expedir factura de venta"},"items":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code_reference":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"quantity":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"price":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$","description":"Precio unitario sin impuestos ni descuentos"},"discount_rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"discount_amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"unit_measure_code":{"type":"string","minLength":1},"standard_code":{"type":"string","minLength":1},"note":{"type":"string","maxLength":500},"taxes":{"minItems":1,"type":"array","items":{"type":"object","properties":{"code":{"type":"string","const":"01"},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"is_excluded":{"type":"boolean"}},"required":["code","rate"]}},"withholding_taxes":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","minLength":1},"rate":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"}},"required":["code","rate"]}}},"required":["code_reference","name","quantity","price","unit_measure_code","standard_code","taxes"]}},"payment_details":{"minItems":1,"type":"array","items":{"type":"object","properties":{"payment_form":{"type":"string","enum":["cash","credit"]},"payment_method_code":{"type":"string","minLength":1},"reference_code":{"type":"string"},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"due_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_form","payment_method_code","amount"]}},"numbering_prefix":{"description":"Prefijo de la resolucion autorizada. Necesario solo con mas de un rango activo.","type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":500},"created_time":{"description":"Hora de creacion. La fecha la pone el proveedor tecnologico.","type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"},"support_document_number":{"type":"string","minLength":1,"description":"Numero del documento soporte que se ajusta"},"correction_concept_code":{"type":"string","enum":["1","2","3","4","5"],"description":"1 devolucion parcial · 2 anulacion del documento soporte · 3 rebaja o descuento · 4 ajuste de precio · 5 otros. NO es el catalogo de la nota credito: aqui el 5 es \"otros\"."}},"required":["provider","items","payment_details","support_document_number","correction_concept_code"],"description":"Nota de ajuste a documento soporte"},"CreatePayroll":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"settlement_period":{"type":"object","properties":{"month":{"type":"integer","minimum":1,"maximum":12},"year":{"type":"integer","minimum":2000,"maximum":2100},"payroll_period_code":{"type":"string","minLength":1},"pay_period_half":{"description":"Obligatorio en periodos quincenales","type":"string"}},"required":["month","year","payroll_period_code"]},"payment":{"type":"object","properties":{"payment_method_code":{"type":"string","minLength":1},"bank_name":{"type":"string"},"account_type":{"type":"string"},"account_number":{"type":"string"},"payment_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["payment_method_code","payment_date"],"description":"Los datos bancarios son obligatorios con el metodo 47 (transferencia)"},"worker":{"type":"object","properties":{"identification_document_code":{"type":"string","minLength":1},"identification_number":{"type":"string","minLength":1},"first_name":{"type":"string","minLength":1},"other_names":{"type":"string"},"first_surname":{"type":"string","minLength":1},"second_surname":{"type":"string","minLength":1},"address":{"type":"string","minLength":1},"country_code":{"default":"CO","type":"string"},"municipality_code":{"description":"Obligatorio cuando el pais es Colombia","type":"string"},"has_integral_salary":{"type":"boolean"},"has_high_risk":{"type":"boolean","description":"Si laboro en actividad de alto riesgo en el periodo"},"worker_type_code":{"type":"string","minLength":1},"worker_subtype":{"type":"string","minLength":1},"contract_type":{"type":"string","minLength":1},"employee_code":{"description":"Codigo interno del trabajador en la empresa","type":"string"},"salary":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"entry_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"days_worked":{"type":"integer","minimum":0,"maximum":9007199254740991},"retirement_date":{"description":"Solo si el trabajador se retira en este periodo","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["identification_document_code","identification_number","first_name","first_surname","second_surname","address","has_integral_salary","has_high_risk","worker_type_code","worker_subtype","contract_type","salary","entry_date","days_worked"],"description":"Trabajador al que corresponde la nomina"},"accruals":{"type":"object","properties":{"basic_salary":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"severance":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"service_bonus":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"bonuses":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"vouchers":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"transport_allowance":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"compensations":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"other_payments":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"leaves":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"vacations":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"sick_leaves":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"assistance":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"legal_strikes":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"commissions":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"third_party_payments":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"workwear":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"apprenticeship_support":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"telecommuting":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"retirement":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"indemnity":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"refund":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"advances":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"overtime_and_surcharges":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]}},"description":"Devengados. `basic_salary` es obligatorio."},"deductions":{"type":"object","properties":{"health":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"pension":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"pension_solidarity_fund":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"union":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"sanctions":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"payroll_loans":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"third_party_payments":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"advances":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"other_deductions":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"voluntary_pension":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"withholding_tax":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"afc_savings":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"cooperative":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"garnishment":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"complementary_plans":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"education":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"refund":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]},"company_debt":{"anyOf":[{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"},{"type":"array","items":{"type":"object","properties":{"type_code":{"description":"Subtipo dentro del concepto (catalogo DIAN). Ej.: cesantia frente a sus intereses.","type":"string","minLength":1},"amount":{"type":"string","pattern":"^-?\\d+(\\.\\d{1,2})?$"},"quantity":{"description":"Dias, horas o unidades segun el concepto","type":"integer","minimum":0,"maximum":9007199254740991},"percentage":{"type":"string","pattern":"^\\d+(\\.\\d{1,2})?$"},"start_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"end_date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"description":{"type":"string","maxLength":500}},"description":"Concepto de nomina"}}]}},"description":"Deducciones. `health` y `pension` son aportes de ley y son obligatorios."},"numbering_prefix":{"type":"string","minLength":1,"maxLength":10},"observation":{"type":"string","maxLength":500}},"required":["settlement_period","payment","worker","accruals","deductions"],"description":"Nomina electronica"},"CreatePayrollAdjustment":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"payroll_number":{"type":"string","minLength":1,"description":"Numero de la nomina que se elimina"},"numbering_prefix":{"description":"Prefijo del rango de ELIMINACIONES, que es distinto del de nominas","type":"string","minLength":1,"maxLength":10}},"required":["payroll_number"],"description":"Nota de ajuste de nomina: eliminacion de una nomina emitida"},"Accepted":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"transaction_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"status":{"type":"string"},"deduplicated":{"type":"boolean","description":"true cuando la peticion era un reintento ya conocido"},"totals":{"type":"object","properties":{"gross_amount":{"type":"string"},"discount_amount":{"type":"string"},"taxable_amount":{"type":"string"},"tax_amount":{"type":"string"},"withholding_amount":{"type":"string"},"total":{"type":"string"}},"required":["gross_amount","discount_amount","taxable_amount","tax_amount","withholding_amount","total"]},"cash_rounding_amount":{"type":"string"}},"required":["transaction_id","status","deduplicated","totals","cash_rounding_amount"]},"Document":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string"},"status":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]},"document_number":{"type":["string","null"]},"cufe":{"type":["string","null"]},"correlation_id":{"type":"string"},"created_at":{"type":"string"},"warnings":{"anyOf":[{},{"type":"null"}],"description":"Notificaciones de la autoridad tributaria. Presentes incluso en documentos validados."}},"required":["id","kind","status","document_number","cufe","correlation_id","created_at","warnings"]},"ReceivedDocumentList":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador en el proveedor tecnologico. Es el que exige POST /v1/received-documents/{id}/events."},"number":{"type":"string","description":"Numero del documento del emisor"},"cufe":{"type":"string","description":"Codigo unico ante la autoridad tributaria"},"kind":{"type":"string","description":"Tipo de documento recibido"},"issue_date":{"type":"string","description":"Fecha de emision, YYYY-MM-DD en calendario colombiano"},"received_at":{"description":"Momento en que el proveedor lo recibio, ISO 8601","type":["string","null"]},"issuer":{"type":"object","properties":{"tax_id":{"type":"string","description":"NIT del emisor, sin digito de verificacion"},"name":{"type":"string"}},"required":["tax_id","name"]},"totals":{"type":"object","properties":{"subtotal":{"description":"null cuando el listado del proveedor no trae el desglose","type":["string","null"]},"tax_amount":{"type":["string","null"]},"total":{"type":"string"}},"required":["subtotal","tax_amount","total"]},"acknowledgement_state":{"anyOf":[{"type":"string","enum":["received","acknowledged","goods_received","claimed","accepted"]},{"type":"null"}],"description":"Estado Radian informado por el proveedor. null = no lo informa."}},"required":["id","number","cufe","kind","issue_date","received_at","issuer","totals","acknowledgement_state"],"description":"Documento electronico recibido de un tercero"}},"count":{"type":"number","description":"Documentos devueltos en esta respuesta"}},"required":["data","count"],"description":"Bandeja de entrada de documentos recibidos"},"ReceptionEvent":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string","enum":["acknowledgement","goods_receipt","claim","express_acceptance","tacit_acceptance"],"description":"acknowledgement acuse de recibo · goods_receipt recibo del bien o servicio · claim reclamo · express_acceptance aceptacion expresa · tacit_acceptance aceptacion tacita"},"actor":{"type":"object","properties":{"identification_document_code":{"type":"string","minLength":1,"description":"Tipo de documento de quien responde (catalogo DIAN; 31 = NIT)"},"identification":{"type":"string","minLength":1,"description":"Sin digito de verificacion"},"first_name":{"type":"string","minLength":1},"last_name":{"type":"string","minLength":1},"job_title":{"type":"string","minLength":1},"organization_department":{"type":"string","minLength":1}},"required":["identification_document_code","identification","first_name","last_name","job_title","organization_department"],"description":"Quien responde por el receptor ante la DIAN"},"claim_concept_code":{"description":"Causal del reclamo. Obligatoria cuando type es \"claim\" e ignorada en los demas eventos.","type":"string","minLength":1}},"required":["type","actor"],"description":"Evento Radian sobre un documento recibido"},"ReceptionEventAccepted":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string","description":"Identificador del documento en el proveedor tecnologico"},"type":{"type":"string","description":"Evento registrado"},"status":{"type":"string","const":"accepted"},"acknowledged_at":{"type":"string","description":"Momento en que el proveedor dio por registrado el evento, ISO 8601"}},"required":["id","type","status","acknowledged_at"],"description":"Evento Radian registrado"},"DocumentList":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"kind":{"type":"string"},"status":{"type":"string","enum":["pending","sent","validated","rejected","failed","cancelled"]},"document_number":{"type":["string","null"]},"cufe":{"type":["string","null"]},"correlation_id":{"type":"string"},"created_at":{"type":"string"},"warnings":{"anyOf":[{},{"type":"null"}],"description":"Notificaciones de la autoridad tributaria. Presentes incluso en documentos validados."}},"required":["id","kind","status","document_number","cufe","correlation_id","created_at","warnings"]}},"page":{"type":"number"},"per_page":{"type":"number"},"total":{"type":"number","description":"Documentos que cumplen el filtro, no los de esta pagina"}},"required":["data","page","per_page","total"],"description":"Listado paginado de documentos emitidos"},"DocumentEventList":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Numero del evento"},"cude":{"type":"string","description":"Codigo unico del evento ante la autoridad"},"code":{"type":"string","description":"Codigo DIAN del evento (030-034)"},"name":{"type":"string"},"occurred_at":{"type":"string","description":"Instante del evento en ISO 8601, anclado a la zona horaria de Colombia"}},"required":["number","cude","code","name","occurred_at"],"description":"Evento Radian ocurrido sobre un documento que emitimos"}},"count":{"type":"number"}},"required":["data","count"],"description":"Eventos Radian sobre un documento emitido"},"NumberingRangeList":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number","description":"Identificador del rango en el proveedor tecnologico"},"kind":{"description":"Tipo de documento ya traducido. null cuando el rango es de un tipo que este servicio no emite.","type":["string","null"]},"prefix":{"type":"string","description":"El valor que se declara como numbering_prefix al emitir"},"from":{"type":"number"},"to":{"type":"number"},"current":{"type":"number","description":"Ultimo consecutivo consumido"},"is_active":{"type":"boolean"}},"required":["id","kind","prefix","from","to","current","is_active"],"description":"Rango de numeracion autorizado por la DIAN"}},"count":{"type":"number"}},"required":["data","count"],"description":"Rangos de numeracion autorizados"},"SendEmail":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"email":{"type":"string","format":"email","pattern":"^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"}},"required":["email"],"description":"Reenvio de un documento por correo"},"UploadReceived":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cufe":{"type":"string","minLength":1,"description":"CUFE de la factura que nos emitieron. Es el unico dato que la autoridad necesita para localizarla."}},"required":["cufe"],"description":"Carga de una factura recibida en la bandeja"},"Problem":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"number"},"code":{"type":"string"},"detail":{"type":"string"},"correlation_id":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["type","title","status","code","correlation_id"],"description":"Error en formato RFC 7807"}}}}