{"swagger":"2.0","x-id":["reitit.swagger/default"],"info":{"title":"Referencia del API","version":"2025-11-25","description":"El API de Dátil está organizado alrededor de recursos REST. Recibe y responde datos en formato JSON.\n\n# Autenticación\nEl API de Dátil utiliza API Keys para autenticar las solicitudes. Puedes obtener tus API Keys desde el [Panel Dátil](https://app.datil.com). Cada cuenta Dátil tiene API Keys separados para pruebas y producción respectivamente.\n\nTodas las solicitudes deben ser realizadas mediante [HTTPS](http://en.wikipedia.org/wiki/HTTP_Secure).\n\n<!-- ReDoc-Inject: <security-definitions> -->","x-logo":{"url":"https://datil-public.s3.us-west-2.amazonaws.com/datil_logo_api_reference.svg","backgroundColor":"#fafafa","altText":"Datil.com"}},"securityDefinitions":{"api_key":{"type":"apiKey","description":"Tu API key de pruebas o producción.","name":"X-Api-Key","in":"header"}},"tags":[{"name":"Tipos de identificación","description":"\n## Identificaciones de Ecuador\n\n | Tipo de identificación | Código API | Código SRI\n |------------------------|------------|-----------\n | RUC | ec-ruc | 06 | \n | Cédula | ec-cedula | 05 |\n | Pasaporte | ec-pasaporte | 06 |\n | Consumidor final * | ec-consumidor-final | 07 |\n | Identificación del exterior | ec-identificacion-exterior | 08 |\n\n  * En ventas a Consumidor Final la identificación del cliente de ser _9999999999999_ (13 dígitos nueve).\n\n## Identificaciones de Perú\n\n | Tipo de identificación | Código API | Código SUNAT\n |------------------------|------------|-----------\n | Sin documento de identidad | pe-no-tax-id | 0 | \n | DNI | pe-dni | 1 |\n | Carnet de extranjería | pe-carnet-extranjeria | 4 |\n | RUC | pe-ruc | 6 |\n | Pasaporte | pe-pasaporte | 7 |\n | Cédula diplomática | pe-cedula-diplomatica | A |\n | Documento de identidad de no domiciliado | pe-no-domiciliado | B |\n | Tax identification number | pe-numero-identificacion | D |\n | Tarjeta Andina de Migración | pe-tarjeta-andina | E |\n\n","x-traitTag":true},{"name":"Tipos de impuestos","description":"\n## Impuestos de Ecuador\n\n### IVA\n\n El Impuesto al Valor Agregado (IVA) se debe especificar en todas las facturas emitidas en Ecuador, incluso si el producto o servicios no grava impuestos o tiene tarifa 0%.\n\n | Tarifa  | Código API | Código SRI\n |------------------ |------------|-----------\n | 12% | ec-iva-12 | 2 |\n | 0% | ec-iva-0 | 0 |\n | 14% | ec-iva-14 | 3 |\n | No objeto | ec-no-objeto-iva | 6 |\n | Exento | ec-exento-iva | 7 |\n\n### ICE\n\nEl Impuesto a Consumos Especiales (ICE) se debe especificar en los productos o servicios que el SRI determine. Se calcula antes del IVA y puede ser calculado con una tarifa [_ad-valorem_](https://es.wikipedia.org/wiki/Impuesto_ad_valorem) y una tarifa específica (ej. $0.10 por litro de alcohol).\n\n | Tipo de ICE  | Código API | Código SRI\n |------------------ |------------|-----------\n | Bebidas alcohólicas | ec-ice-bebidas-alcoholicas | 3031 |\n | Cervezas artesanales | ec-ice-cerveza-artesanal | 3041 |\n\n<a href=\"#\">Ver todos los códigos de ICE</a>\n\n## Impuestos de Perú\n\n | Tipo de impuesto  | Código API | Código SUNAT\n |-------------------|-------------|------------\n | IGV 18% | pe-igv | 1000 |\n | ISC | pe-isc | 2000 |\n | IVAP | pe-ivap | 1016 |\n | Exportación | pe-exportacion | 9995 |\n | Gratuito | pe-gratuito | 9996 |\n | Exonerado | pe-exonerado | 1000 |\n\n","x-traitTag":true}],"x-tagGroups":[{"name":"Ventas","tags":["Facturas","Boletas","Notas de crédito","Notas de débito","Percepciones","Guías de remisión"]},{"name":"Compras","tags":["Facturas de compra","Retenciones"]},{"name":"Documentos","tags":["Autorización tributaria","Descarga de PDFs"]},{"name":"Configuración","tags":["Parámetros"]},{"name":"Connect","tags":["Cuentas","Consultas de identificación"]},{"name":"Datos públicos","tags":["Entidades tributarias"]},{"name":"Certificados","tags":["Certificados","Firma de documentos"]},{"name":"Catálogos","tags":["Tipos de identificación","Tipos de impuestos"]}],"paths":{"/ack/{id}":{"get":{"responses":{"200":{"schema":{},"description":""},"404":{"schema":{},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga una confirmación de recepción","tags":["Descarga de XMLs"]}},"/d/{id}":{"get":{"responses":{"200":{"schema":{},"description":""},"404":{"schema":{},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga un documento en PDF","tags":["Descarga de PDFs"]}},"/p/{id}":{"get":{"responses":{"200":{"schema":{},"description":""},"404":{"schema":{},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga un documento en PDF","tags":["Descarga de PDFs"]}},"/v/{id}":{"get":{"responses":{"200":{"schema":{},"description":""},"404":{"schema":{},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Verifica un documento legal","tags":["Verificación de documentos"]}},"/digital-signatures/signing-requests/{document-id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la solicitud de firmado.","example":"abc123"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente de la solicitud de firmado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"type":"string","description":"Estatus del proceso de firma del documento:\n\n**draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n**processing**: El documento fue enviado a los firmantes y el sistema está esperando que completen la firma.\n\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser descargado incluyendo las firmas de todos los firmantes.","example":"signed"},"type":{"enum":["ec/qualified","jm/advanced","pa/simple","pe/advanced","br/advanced","bo/advanced","sv/advanced","gt/advanced","hn/advanced","ni/advanced"],"description":"Tipo de solicitud de firmado:\n   **ec/advanced**: Firma electrónica avanzada y cualificada, de acuerdo a Ley de Comercio Electrónico, Firmas Electrónicas y Mensajes de Datos de Ecuador.\n\n   **jm/advanced**: Firma electrónica avanzada con validez legal en Jamaica.\n\n   **pa/simple**: Firma digital simple, de acuerdo a la Ley de Firmas y Certificados Digitales de Panamá.\n\n   **pe/advanced**: Firma digital simple y/o avanzada, de acuerdo a la Ley de Firmas y Certificados Digitales de Perú.\n\n   **br/advanced**: Firma digital avanzada con validez legal en Brasil.\n\n   **bo/advanced**: Firma digital avanzada con validez legal en Bolivia.\n\n   **sv/advanced**: Firma digital avanzada con validez legal en El Salvador.\n\n   **gt/advanced**: Firma digital avanzada con validez legal en Guatemala.\n\n   **hn/advanced**: Firma digital avanzada con validez legal en Honduras.\n\n   **ni/advanced**: Firma digital avanzada con validez legal en Nicaragua.","example":"ec/advanced"},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de firmado, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"signed":{"type":"string","format":"date-time","description":"Fecha en que todos los firmantes firmaron el documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"documents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento.","example":"1234"},"title":{"type":"string","description":"Título del documento","example":"Documento de pruebas"},"notes":{"type":"string","description":"Notas internas sobre el documento. No son visibles para los firmantes.","example":"Nota interna de ejemplo."},"file_extension":{"type":"string","description":"Extensión del archivo del documento.","example":"pdf"},"original_file":{"type":"string","description":"URL del documento original.","example":"https://api.datil.com/d/abcds/pdf"},"original_file_hash":{"type":"string","description":"Cadena del documento original (algoritmo SHA256).","example":"a9975509125e59f02fc36568a17608bf1268609f040b06600df4730fe94ef3b1"},"signed_file":{"type":"string","description":"URL del documento firmado.","example":"https://api.datil.com/d/abcdef/pdf"},"signed_file_hash":{"type":"string","description":"Cadena del documento firmado (algoritmo SHA256).","example":"38b58a284dbfc08180bf8a9693aa72ce749800dbb0f49a510b3fc71cf2d975c5"},"signatures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la firma","example":"1234"},"timestamp":{"type":"string","format":"date-time","description":"Fecha de firmado, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"signing_certificate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"0ca049e5-8d05-4d65-871a-82b6bdf508f7"},"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua."},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del certificado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas.\n\n  Los certificados en ambiente de pruebas simulan su emisión y las acciones\n  que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.\n\n  Los certificados en ambiente de producción si se emiten y tienen costo."},"validity":{"type":"number","format":"double","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":365},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"issued":{"type":"string","format":"date-time","description":"Fecha de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"expiry":{"type":"string","format":"date-time","description":"Fecha de expiración del certificado, en formato RFC3339.","example":"2025-01-01T00:00:00Z"},"serial_number":{"type":"string","description":"Serie del certificado.","example":"11:22:22:22:00:22"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"legal_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828001"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","last_name","email","mobile_phone","legal_id","legal_id_type","address"],"description":"Información del titular del certificado."},"status":{"type":"string","description":"Estado del certificado: issued, draft o processing.","example":"issued"},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["id","type","environment","validity","created","issued","expiry","principal","status"],"description":"Solicitud de creación de un nuevo certificado."},"signing_certificate_hash":{"type":"string","description":"Cadena de los datos del firmante (algoritmo SHA256).","example":"a9974509125e59f02fc36568a29608bf1268609f040b06600df4730fe94ef3b1"},"page":{"type":"string","description":"Número de página de la firma.","example":"1"},"size":{"enum":["s","m","l"],"description":"Tamaño de la firma.\n\n  **s**: Pequeña, QR 150x150px y fuente 9px.\n  **m**: Mediana, QR 300x300px y fuente 11px.\n  **l**: Grande, QR 450x450px y fuente 15px.","example":"m"},"x":{"type":"string","description":"Coordenadas horizontales desde la esquina superior izquierda.","example":"200"},"y":{"type":"string","description":"Coordenadas verticales desde la esquina superior izquierda.","example":"200"}},"required":["id","timestamp","signing_certificate","page","x","y"],"description":"Firma"}}},"required":["id","title","file_extension","original_file","original_file_hash","signed_file","signed_file_hash","signatures"],"description":"Document legal a firmar."}}},"required":["id","environment","status","created","signed","documents"],"description":"Respuesta de firma de un documento."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"document-id","description":"Identificador único de la solicitud de firmado.","type":"string","required":true,"example":"fpLma8KGcVrR77II2-QS-"}],"summary":"Consulta el estado de una solicitud de firmado","tags":["Certificados"]}},"/digital-signatures/signing-requests":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la solicitud de firmado.","example":"abc123"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente de la solicitud de firmado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"type":"string","description":"Estatus del proceso de firma del documento:\n\n**draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n**processing**: El documento fue enviado a los firmantes y el sistema está esperando que completen la firma.\n\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser descargado incluyendo las firmas de todos los firmantes.","example":"signed"},"type":{"enum":["ec/qualified","jm/advanced","pa/simple","pe/advanced","br/advanced","bo/advanced","sv/advanced","gt/advanced","hn/advanced","ni/advanced"],"description":"Tipo de solicitud de firmado:\n   **ec/advanced**: Firma electrónica avanzada y cualificada, de acuerdo a Ley de Comercio Electrónico, Firmas Electrónicas y Mensajes de Datos de Ecuador.\n\n   **jm/advanced**: Firma electrónica avanzada con validez legal en Jamaica.\n\n   **pa/simple**: Firma digital simple, de acuerdo a la Ley de Firmas y Certificados Digitales de Panamá.\n\n   **pe/advanced**: Firma digital simple y/o avanzada, de acuerdo a la Ley de Firmas y Certificados Digitales de Perú.\n\n   **br/advanced**: Firma digital avanzada con validez legal en Brasil.\n\n   **bo/advanced**: Firma digital avanzada con validez legal en Bolivia.\n\n   **sv/advanced**: Firma digital avanzada con validez legal en El Salvador.\n\n   **gt/advanced**: Firma digital avanzada con validez legal en Guatemala.\n\n   **hn/advanced**: Firma digital avanzada con validez legal en Honduras.\n\n   **ni/advanced**: Firma digital avanzada con validez legal en Nicaragua.","example":"ec/advanced"},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de firmado, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"signed":{"type":"string","format":"date-time","description":"Fecha en que todos los firmantes firmaron el documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"documents":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento.","example":"1234"},"title":{"type":"string","description":"Título del documento","example":"Documento de pruebas"},"notes":{"type":"string","description":"Notas internas sobre el documento. No son visibles para los firmantes.","example":"Nota interna de ejemplo."},"file_extension":{"type":"string","description":"Extensión del archivo del documento.","example":"pdf"},"original_file":{"type":"string","description":"URL del documento original.","example":"https://api.datil.com/d/abcds/pdf"},"original_file_hash":{"type":"string","description":"Cadena del documento original (algoritmo SHA256).","example":"a9975509125e59f02fc36568a17608bf1268609f040b06600df4730fe94ef3b1"},"signed_file":{"type":"string","description":"URL del documento firmado.","example":"https://api.datil.com/d/abcdef/pdf"},"signed_file_hash":{"type":"string","description":"Cadena del documento firmado (algoritmo SHA256).","example":"38b58a284dbfc08180bf8a9693aa72ce749800dbb0f49a510b3fc71cf2d975c5"},"signatures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador de la firma","example":"1234"},"timestamp":{"type":"string","format":"date-time","description":"Fecha de firmado, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"signing_certificate":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"0ca049e5-8d05-4d65-871a-82b6bdf508f7"},"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua."},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del certificado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas.\n\n  Los certificados en ambiente de pruebas simulan su emisión y las acciones\n  que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.\n\n  Los certificados en ambiente de producción si se emiten y tienen costo."},"validity":{"type":"number","format":"double","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":365},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"issued":{"type":"string","format":"date-time","description":"Fecha de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"expiry":{"type":"string","format":"date-time","description":"Fecha de expiración del certificado, en formato RFC3339.","example":"2025-01-01T00:00:00Z"},"serial_number":{"type":"string","description":"Serie del certificado.","example":"11:22:22:22:00:22"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"legal_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828001"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","last_name","email","mobile_phone","legal_id","legal_id_type","address"],"description":"Información del titular del certificado."},"status":{"type":"string","description":"Estado del certificado: issued, draft o processing.","example":"issued"},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["id","type","environment","validity","created","issued","expiry","principal","status"],"description":"Solicitud de creación de un nuevo certificado."},"signing_certificate_hash":{"type":"string","description":"Cadena de los datos del firmante (algoritmo SHA256).","example":"a9974509125e59f02fc36568a29608bf1268609f040b06600df4730fe94ef3b1"},"page":{"type":"string","description":"Número de página de la firma.","example":"1"},"size":{"enum":["s","m","l"],"description":"Tamaño de la firma.\n\n  **s**: Pequeña, QR 150x150px y fuente 9px.\n  **m**: Mediana, QR 300x300px y fuente 11px.\n  **l**: Grande, QR 450x450px y fuente 15px.","example":"m"},"x":{"type":"string","description":"Coordenadas horizontales desde la esquina superior izquierda.","example":"200"},"y":{"type":"string","description":"Coordenadas verticales desde la esquina superior izquierda.","example":"200"}},"required":["id","timestamp","signing_certificate","page","x","y"],"description":"Firma"}}},"required":["id","title","file_extension","original_file","original_file_hash","signed_file","signed_file_hash","signatures"],"description":"Document legal a firmar."}}},"required":["id","environment","status","created","signed","documents"],"description":"Respuesta de firma de un documento."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Solicitud de firma de un documento.","required":true,"schema":{"type":"object","properties":{"subject":{"type":"string","description":"Título de la solicitud de firmado."},"type":{"enum":["ec/qualified","jm/advanced","pa/simple","pe/advanced","br/advanced","bo/advanced","sv/advanced","gt/advanced","hn/advanced","ni/advanced"],"description":"Tipo de solicitud de firmado:\n   **ec/qualified**: Firma electrónica avanzada y cualificada, de acuerdo a Ley de Comercio Electrónico, Firmas Electrónicas y Mensajes de Datos de Ecuador.\n\n   **jm/advanced**: Firma electrónica avanzada con validez legal en Jamaica.\n\n   **pa/simple**: Firma digital simple, de acuerdo a la Ley de Firmas y Certificados Digitales de Panamá.\n\n   **pe/advanced**: Firma digital simple y/o avanzada, de acuerdo a la Ley de Firmas y Certificados Digitales de Perú.\n\n   **br/advanced**: Firma digital avanzada con validez legal en Brasil.\n\n   **bo/advanced**: Firma digital avanzada con validez legal en Bolivia.\n\n   **sv/advanced**: Firma digital avanzada con validez legal en El Salvador.\n\n   **gt/advanced**: Firma digital avanzada con validez legal en Guatemala.\n\n   **hn/advanced**: Firma digital avanzada con validez legal en Honduras.\n\n   **ni/advanced**: Firma digital avanzada con validez legal en Nicaragua.","example":"ec/advanced"},"documents":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string","description":"Título del documento","example":"Documento de pruebas"},"notes":{"type":"string","description":"Notas internas sobre el documento. No son visibles para los firmantes.","example":"Nota interna de ejemplo."},"document_base64":{"type":"string","description":"Documento codificado en base64.","example":"abcd"},"file_extension":{"type":"string","description":"Extensión del archivo del documento.","example":"pdf"},"signatures":{"type":"array","items":{"type":"object","properties":{"signing_certificate":{"type":"string","description":"Id del certificado para firmar","example":"123"},"page":{"type":"string","description":"Número de página de la firma.","example":"1"},"size":{"enum":["s","m","l"],"description":"Tamaño de la firma.\n\n  **s**: Pequeña, QR 150x150px y fuente 9px.\n  **m**: Mediana, QR 300x300px y fuente 11px.\n  **l**: Grande, QR 450x450px y fuente 15px.","example":"m"},"x":{"type":"string","description":"Coordenadas horizontales desde la esquina superior izquierda.","example":"200"},"y":{"type":"string","description":"Coordenadas verticales desde la esquina superior izquierda.","example":"200"}},"required":["signing_certificate","page","x","y"],"description":"Firma"}}},"required":["title","document_base64","file_extension","signatures"],"description":"Document legal a firmar."}}},"required":["subject","documents"],"description":"Solicitud de firma de un documento."}}],"summary":"Crea una solicitud de firma de documento","tags":["Certificados"]}},"/certificates/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"0ca049e5-8d05-4d65-871a-82b6bdf508f7"},"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua."},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del certificado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas.\n\n  Los certificados en ambiente de pruebas simulan su emisión y las acciones\n  que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.\n\n  Los certificados en ambiente de producción si se emiten y tienen costo."},"validity":{"type":"number","format":"double","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":365},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"issued":{"type":"string","format":"date-time","description":"Fecha de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"expiry":{"type":"string","format":"date-time","description":"Fecha de expiración del certificado, en formato RFC3339.","example":"2025-01-01T00:00:00Z"},"serial_number":{"type":"string","description":"Serie del certificado.","example":"11:22:22:22:00:22"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"legal_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828001"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","last_name","email","mobile_phone","legal_id","legal_id_type","address"],"description":"Información del titular del certificado."},"status":{"type":"string","description":"Estado del certificado: issued, draft o processing.","example":"issued"},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["id","type","environment","validity","created","issued","expiry","principal","status"],"description":"Solicitud de creación de un nuevo certificado."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta un certificado","tags":["Certificados"]}},"/certificates":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"0ca049e5-8d05-4d65-871a-82b6bdf508f7"},"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua."},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del certificado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas.\n\n  Los certificados en ambiente de pruebas simulan su emisión y las acciones\n  que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.\n\n  Los certificados en ambiente de producción si se emiten y tienen costo."},"validity":{"type":"number","format":"double","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":365},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"issued":{"type":"string","format":"date-time","description":"Fecha de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"expiry":{"type":"string","format":"date-time","description":"Fecha de expiración del certificado, en formato RFC3339.","example":"2025-01-01T00:00:00Z"},"serial_number":{"type":"string","description":"Serie del certificado.","example":"11:22:22:22:00:22"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"legal_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828001"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","last_name","email","mobile_phone","legal_id","legal_id_type","address"],"description":"Información del titular del certificado."},"status":{"type":"string","description":"Estado del certificado: issued, draft o processing.","example":"issued"},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["id","type","environment","validity","created","issued","expiry","principal","status"],"description":"Solicitud de creación de un nuevo certificado."}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"status","description":"Estados de los certificados a consultar: draft, processing, issued, revoked, rejected o expired","type":"string","required":false,"example":"issued,revoked,expired"}],"summary":"Lista tus certificados","tags":["Certificados"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identificador único del certificado, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"0ca049e5-8d05-4d65-871a-82b6bdf508f7"},"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua."},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del certificado.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas.\n\n  Los certificados en ambiente de pruebas simulan su emisión y las acciones\n  que realices con ellos (ej. firmas electrónicas), por lo que no tienen costo.\n\n  Los certificados en ambiente de producción si se emiten y tienen costo."},"validity":{"type":"number","format":"double","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":365},"created":{"type":"string","format":"date-time","description":"Fecha de creación de la solicitud de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"issued":{"type":"string","format":"date-time","description":"Fecha de emisión del certificado, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"expiry":{"type":"string","format":"date-time","description":"Fecha de expiración del certificado, en formato RFC3339.","example":"2025-01-01T00:00:00Z"},"serial_number":{"type":"string","description":"Serie del certificado.","example":"11:22:22:22:00:22"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"legal_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828001"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","last_name","email","mobile_phone","legal_id","legal_id_type","address"],"description":"Información del titular del certificado."},"status":{"type":"string","description":"Estado del certificado: issued, draft o processing.","example":"issued"},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["id","type","environment","validity","created","issued","expiry","principal","status"],"description":"Solicitud de creación de un nuevo certificado."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Solicitud de creación de un nuevo certificado.","required":true,"schema":{"type":"object","properties":{"type":{"enum":["ec/instant","ec/individual","ec/sole-proprietorship","ec/business-director","ec/business-employee","ec/organization","jm/instant","pa/instant","pe/instant","br/instant","bo/instant","sv/instant","gt/instant","hn/instant","ni/instant"],"description":"Tipo de certificado:\n   **ec/instant**: Certificado instantáneo con validez de 1 día, solo para personas naturales.\n   **ec/individual**: Certificado para persona natural, solo con número de cédula. No incluye el RUC del titular.\n\n   **ec/sole-proprietorship**: Certificado para persona natural con RUC.\n\n   **ec/business-director**: Certificado para representante legal de una empresa.\n\n   **ec/business-employee**: Certificado para miembro de una empresa (ej. contador).\n\n   **ec/organization**: Certificado para representante legal de organizaciones públicas o privadas.\n\n   **jm/instant**: Certificado virtual para firma simple en Jamaica.\n\n   **pe/instant**: Certificado virtual para firma simple en Perú.\n\n   **pa/instant**: Certificado virtual para firma simple en Panamá.\n   **br/instant**: Certificado virtual para firma simple en Brasil.\n\n   **bo/instant**: Certificado virtual para firma simple en Bolivia.\n\n   **sv/instant**: Certificado virtual para firma simple en El Salvador.\n\n   **gt/instant**: Certificado virtual para firma simple en Guatemala.\n\n   **hn/instant**: Certificado virtual para firma simple en Honduras.\n\n   **ni/instant**: Certificado virtual para firma simple en Nicaragua.","example":"ec/individual"},"validity":{"type":"string","description":"Validez del certificado en días. Valores aceptados: 1, 365, 732, 1095, 1825","example":"365"},"password":{"type":"string","description":"Contraseña del certificado.","example":"clave-de-pruebas"},"principal":{"type":"object","properties":{"first_name":{"type":"string","description":"Primer nombre","example":"Juan"},"middle_name":{"type":"string","description":"Segundo nombre","example":"Andres"},"last_name":{"type":"string","description":"Apellido","example":"Martinez"},"second_last_name":{"type":"string","description":"Segundo apellido","example":"Lopez"},"email":{"type":"string","description":"Email del titular","example":"prueba@prueba.com"},"mobile_phone":{"type":"string","description":"Celular del titular","example":"0999999999"},"legal_id_type":{"type":"string","description":"Tipo de identificación legal del titular.","example":"ec-cedula"},"legal_id":{"type":"string","description":"Identificación legal del titular.","example":"0922288828"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"},"tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del titular.","example":"ec-ruc"},"tax_id":{"type":"string","description":"Identificación tributaria del titular.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"selfie_photo":{"type":"string","description":"Foto selfie codificada como base64.","example":"abcd"},"id_service_photo":{"type":"string","description":"Foto de un servicio de identificación codificada como base64.","example":"abcd"},"ip_address":{"type":"string","description":"Dirección IP del solicitante del certificado.","example":"10.0.0.1"},"user_agent":{"type":"string","description":"Detalle sobre el tipo de dispositivo del solicitante del certificado.","example":"WhatsApp"},"proof_of_id":{"type":"string","description":"URL o contenido base64 de la verificación de identidad del solicitante","example":"https://portal.com/id/12345"}},"required":["first_name","email","mobile_phone","legal_id_type","legal_id"],"description":"Información del titular del certificado."},"organization":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la organización.","example":"Empresa S.A."},"tax_id_type":{"type":"string","description":"Tipo de identificación legal de la organización.","example":"ec-ruc"},"tax_id":{"type":"string","description":"Identificación legal de la organización.","example":"0922288828"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"position":{"type":"string","description":"Posición del titular en una organización.","example":"Gerente General"}},"required":["legal_name","tax_id_type","tax_id","address"],"description":"Información de la organización a la que pertenece certificado."}},"required":["type","validity","principal"],"description":"Solicitud de creación de un nuevo certificado."}}],"summary":"Crea un nuevo certificado","tags":["Certificados"]}},"/settings":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único de configuración.","example":"C0f6RAn3sV7cHDHvChciT"},"setting":{"type":"object","properties":{"key":{"type":"string","description":"Clave de la configuración.","example":"validation.rounding-mode"},"type":{"type":"string","description":"Tipo de datos de la configuración.","example":":keyword"}},"required":["key","type"],"description":"Configuración"},"value":{"type":"string","description":"Valor de la configuración.","example":":active"}},"required":["id","setting","value"],"description":"Lista de configuraciones de la cuenta."}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[],"summary":"Lista los parámetros de una cuenta","tags":["Parámetros"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único de configuración.","example":"C0f6RAn3sV7cHDHvChciT"},"setting":{"type":"object","properties":{"key":{"type":"string","description":"Clave de la configuración.","example":"validation.rounding-mode"},"type":{"type":"string","description":"Tipo de datos de la configuración.","example":":keyword"}},"required":["key","type"],"description":"Configuración"},"value":{"type":"string","description":"Valor de la configuración.","example":":active"}},"required":["id","setting","value"],"description":"Lista de configuraciones de la cuenta."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Nueva configuración.","required":true,"schema":{"type":"object","properties":{"setting":{"type":"object","properties":{"key":{"type":"string","description":"Identificación de la configuración.","example":"sample-setting.sample-attribute"}},"required":["key"],"description":"Configuración."},"value":{"type":"string","description":"Valor de la configuración.","example":"Test"}},"required":["setting","value"],"description":"Nueva configuración."}}],"summary":"Crea un nueva parámetro.","tags":["Parámetros"]}},"/accounts":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la cuenta.","example":"Empresa SAC"},"commercial_name":{"type":"string","description":"Nombre comercial de la cuenta.","example":"Comercial ABC"},"tax_id":{"type":"string","description":"Identificación tributaria de la cuenta.","example":"09111111222"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","ubigeo","tax_code","country"],"description":"Dirección de la cuenta."},"api_keys":{"type":"array","items":{"type":"object","properties":{"token":{"type":"string","description":"Token del API key. Mantenlo en un lugar seguro.","example":"1233455848484884"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del API key.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"enum":["public","secret"],"description":"Tipo de sudo del API key.\n\n  **public**: Uso público \n  **secret**: Uso privado."}},"required":["token","environment","type"],"description":"API key para acceder a la cuenta."}}},"required":["legal_name","commercial_name","tax_id","tax_id_type","country","address","api_keys"],"description":"Respuesta de la nueva cuenta."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre legal de la cuenta.","example":"Empresa SAC"},"commercial_name":{"type":"string","description":"Nombre comercial de la cuenta.","example":"Comercial ABC"},"tax_id":{"type":"string","description":"Identificación tributaria de la cuenta.","example":"09111111222"},"tax_id_type":{"type":"string","description":"Tipo de la identificación tributaria de la cuenta.","example":"pe-ruc"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"09111111222"},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección de la cuenta."}},"required":["legal_name","commercial_name","tax_id","tax_id_type","country","address"]}}],"summary":"Crea una cuenta","tags":["Cuentas"]}},"/documents/{id}/tax-clearance":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una autorización","tags":["Autorización tributaria"]}},"/documents/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga un XML","tags":["Autorización tributaria"]}},"/sales/waybills":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las guías de remisión emitidas","tags":["Guías de remisión"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Solicitud de creación de nueva guía de remisión.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del receptor.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del receptor.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"tax-id":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"tax-id-type":{"type":"string","description":"Tipo de identificación tributaria del tercero.","example":"pe-ruc"}},"required":["legal_name","tax-id","tax-id-type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"string","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","description":"Fecha de inicio del traslado","example":"2021-08-01"},"delivery_date":{"type":"string","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2021-08-01"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"string","description":"Tipo de documento de identidad del transportista (Transporte público).","example":"pe-ruc"},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"string","description":"Tipo de documento de identidad del conductor (Transporte privado).","example":"pe-ruc"}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","line_items"],"description":"Solicitud de creación de nueva guía de remisión."}}],"summary":"Emite una guía de remisión","tags":["Guías de remisión"]}},"/sales/waybills/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de guías de remisión en CSV","tags":["Guías de remisión"]}},"/sales/waybills/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una guía de remisión","tags":["Guías de remisión"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"Solicitud de creación de nueva guía de remisión.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del receptor.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del receptor.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"tax-id":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"tax-id-type":{"type":"string","description":"Tipo de identificación tributaria del tercero.","example":"pe-ruc"}},"required":["legal_name","tax-id","tax-id-type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"string","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","description":"Fecha de inicio del traslado","example":"2021-08-01"},"delivery_date":{"type":"string","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2021-08-01"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"string","description":"Tipo de documento de identidad del transportista (Transporte público).","example":"pe-ruc"},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"string","description":"Tipo de documento de identidad del conductor (Transporte privado).","example":"pe-ruc"}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","line_items"],"description":"Solicitud de creación de nueva guía de remisión."}}],"summary":"Actualiza una guía de remisión","tags":["Guías de remisión"]}},"/sales/waybills/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una guía de remisión","tags":["Guías de remisión"]}},"/sales/waybills/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una guía de remisión a la autoridad tributaria","tags":["Guías de remisión"]}},"/sales/waybills/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"T001-1"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/waybill"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"order_reference":{"type":"object","properties":{"number":{"type":"string","description":"Número de la guían de remisión física.","example":"T001-00001"},"type":{"type":"string","description":"Tipo de la guía de remisión física. Siempre es _09_.","example":"09"}},"required":["number","type"],"description":"Información de guías de remisión físicas emitidas previamente, que serán reemplazadas por la electrónica."},"related_document":{"type":"object","properties":{"number":{"type":"string","description":"Número de documento relacionado.","example":"F001-00001"},"type":{"type":"string","description":"Número de documento relacionado.","example":"01"}},"required":["number","type"],"description":"Información del documento relacionado a la guía de remisión."},"recipient_legal_name":{"type":"string","description":"Nombre del receptor.","example":"Jose Mario"},"recipient_commercial_name":{"type":"string","description":"Nombre comercial del receptor.","example":"Jose Mario"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"supplier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del tercero.","example":"Jose Mario"},"number":{"type":"string","description":"Identificación tributaria del tercero.","example":"212334567"},"type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"required":["legal_name","number","type"],"description":"Información del establecimiento de un tercero, cuando aplique."},"shipment":{"type":"object","properties":{"handling_code":{"type":"string","description":"Código del motivo del traslado.","example":"01"},"description":{"type":"string","description":"Descripción del motivo del traslado.","example":"Venta de productos"},"weight_unit":{"type":"string","description":"Código de la unidad de peso.","example":"KG"},"weight":{"type":"number","format":"double","description":"Peso del envío.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad de ítems en el envío. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"scheduled_transfer":{"type":"boolean","description":"Indica si el envío requiere trasbordo programado.","example":false},"transport_mode_code":{"type":"string","description":"Código de la modalidad de traslado.","example":"01"},"start_date":{"type":"string","format":"date-time","description":"Fecha de inicio del traslado","example":"2026-10-07T17:29:46Z"},"delivery_date":{"type":"string","format":"date-time","description":"Fecha de entrega de bienes al transportista (aplica cuando la modalidad de traslado es transporte público = 01).","example":"2026-10-07T17:29:46Z"},"carrier":{"type":"object","properties":{"legal_name":{"type":"string","description":"Nombre del transportista (trasporte público).","example":"Transportes Dátil"},"tax_id":{"type":"string","description":"Identificación tributaria del transportista (trasporte público).","example":"20601595665"},"tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"license_plate":{"type":"string","description":"Número de placa del vehículo (trasporte privado).","example":"GSI-999"},"email":{"type":"string","description":"Email del transportista.","example":"prueba@prueba.com"},"driver_id":{"type":"string","description":"Número de documento de identidad del conductor (transporte privado).","example":"Transportes Dátil"},"driver_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."}},"description":"Datos del transportista."},"address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"origin_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"container_number":{"type":"string","description":"Número del contenedor (cuado el motivo es importación).","example":"1"},"port_code":{"type":"string","description":"Código del puerto.","example":"222"}},"required":["handling_code","description","weight_unit","weight","scheduled_transfer","transport_mode_code","start_date","carrier","address","origin_address"],"description":"Información del envío."},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"}},"required":["sku","description","quantity"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una guía de remisión."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","environment","status","type","country","series","sequence","recipient_legal_name","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items"],"description":"Respuesta de una nueva guía de remisión."},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una guía de remisión por email al cliente","tags":["Guías de remisión"]}},"/sales/waybills/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una guía de remisión","tags":["Guías de remisión"]}},"/sales/receipts":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las boletas emitidas","tags":["Boletas"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda del documento.","example":"PEN"},"total":{"type":"string","description":"Monto total del anticipo (incluye impuestos).","example":"118.00"},"subtotal":{"type":"string","description":"Subtotal del anticipo, sin incluir impuestos.","example":"100.00"}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo: '04' gravado/IGV/exportación, '05' exonerado, '06' inafecto, '20' ISC. Si no se envía, se deriva automáticamente del tipo de operación de las líneas.","example":"05"},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total"]}}],"summary":"Emite una boleta","tags":["Boletas"]}},"/sales/receipts/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de boletas en CSV","tags":["Boletas"]}},"/sales/receipts/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una boleta","tags":["Boletas"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda del documento.","example":"PEN"},"total":{"type":"string","description":"Monto total del anticipo (incluye impuestos).","example":"118.00"},"subtotal":{"type":"string","description":"Subtotal del anticipo, sin incluir impuestos.","example":"100.00"}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo: '04' gravado/IGV/exportación, '05' exonerado, '06' inafecto, '20' ISC. Si no se envía, se deriva automáticamente del tipo de operación de las líneas.","example":"05"},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total"]}}],"summary":"Actualiza una boleta","tags":["Boletas"]}},"/sales/receipts/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una boleta","tags":["Boletas"]}},"/sales/receipts/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una boleta a la autoridad tributaria","tags":["Boletas"]}},"/sales/receipts/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"B001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"]}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una boleta por email al cliente","tags":["Boletas"]}},"/sales/receipts/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una boleta","tags":["Boletas"]}},"/sales/credit-notes":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las notas de crédito emitidas","tags":["Notas de crédito"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]}}],"summary":"Emite una nota de crédito","tags":["Notas de crédito"]}},"/sales/credit-notes/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de notas de crédito en CSV","tags":["Notas de crédito"]}},"/sales/credit-notes/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una nota de crédito","tags":["Notas de crédito"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]}}],"summary":"Actualiza una nota de crédito","tags":["Notas de crédito"]}},"/sales/credit-notes/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una nota de crédito","tags":["Notas de crédito"]}},"/sales/credit-notes/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una nota de crédito a la autoridad tributaria","tags":["Notas de crédito"]}},"/sales/credit-notes/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"credit_reason_code":{"type":"string","description":"Código del tipo de nota de crédito. Ver Tipos de notas de crédito.","example":"01"},"credit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"01"},"credit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de crédito.","example":"Devolución del producto."},"credited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"credited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"credited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-credit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de crédito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura relacionada, en caso de aplicar."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","credit_reason_code","credit_reason_note","credit_reason_description","credited_document_type","credited_document_number"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una nota de crédito por email al cliente","tags":["Notas de crédito"]}},"/sales/credit-notes/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una nota de crédito","tags":["Notas de crédito"]}},"/sales/debit-notes":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las notas de débito emitidas","tags":["Notas de débito"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de dédito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","tax_lines","subtotal","tax","total","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]}}],"summary":"Emite una nota de débito","tags":["Notas de débito"]}},"/sales/debit-notes/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de notas de débito en CSV","tags":["Notas de débito"]}},"/sales/debit-notes/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una nota de débito","tags":["Notas de débito"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de dédito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","tax_lines","subtotal","tax","total","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]}}],"summary":"Actualiza una nota de débito","tags":["Notas de débito"]}},"/sales/debit-notes/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una nota de débito","tags":["Notas de débito"]}},"/sales/debit-notes/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una nota de débito a la autoridad tributaria","tags":["Notas de débito"]}},"/sales/debit-notes/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la factura en formato RFC3339."},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"debit_reason_code":{"type":"string","description":"Código del tipo de nota de débito. Ver Tipos de notas de débito.","example":"01"},"debit_reason_note":{"type":"string","description":"Notas sobre la razón de la emisión del documento.","example":"Devolución del producto."},"debit_reason_description":{"type":"string","description":"Descripción de la razón de la nota de débito.","example":"Devolución del producto."},"debited_document_type":{"type":"string","description":"Código del tipo de documento afectado. Ver tipos de documento.","example":"01"},"debited_document_number":{"type":"string","description":"Número del documento afectado. Ver Especificación de numeración.","example":"F001-2"},"debited_document_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato RFC3339."},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-debit-note"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"FC01-1"},"series":{"type":"string","description":"Serie del documento.","example":"FC01"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en datos del comprador."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","status","type","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una nota de débito."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words","debit_reason_code","debit_reason_note","debit_reason_description","debited_document_type","debited_document_number"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una nota de débito por email al cliente","tags":["Notas de débito"]}},"/sales/debit-notes/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una nota de débito","tags":["Notas de débito"]}},"/sales/invoices":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las facturas emitidas","tags":["Facturas"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Solicitud de creación de nueva factura.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"due_date":{"type":"string","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"string","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":"9.00"},"amount":{"type":"string","description":"Monto de la detracción con dos decimales.","example":"1000.00"}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"incoterm":{"type":"string","description":"Código INCOTERM","example":"EXW"},"freight_charge":{"type":"string","description":"Costo del flete.","example":"100.00"},"insurance_charge":{"type":"string","description":"Costo del seguro.","example":"100.00"},"other_charges":{"type":"string","description":"Otros cargos.","example":"100.00"},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"string","description":"Peso bruto de la carga.","example":"0.0"},"net_weight":{"type":"string","description":"Peso neto de la carga.","example":"0.0"},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"string","description":"Total del descuento.","example":"100.00"}},"required":["incoterm","freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda del documento.","example":"PEN"},"total":{"type":"string","description":"Monto total del anticipo (incluye impuestos).","example":"118.00"},"subtotal":{"type":"string","description":"Subtotal del anticipo, sin incluir impuestos.","example":"100.00"}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo: '04' gravado/IGV/exportación, '05' exonerado, '06' inafecto, '20' ISC. Si no se envía, se deriva automáticamente del tipo de operación de las líneas.","example":"05"},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"string","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":"0.03"},"amount":{"type":"string","description":"Monto retenido.","example":"1133.42"},"base_amount":{"type":"string","description":"Base del cálculo de la retención.","example":"37780.81"}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total"],"description":"Solicitud de creación de nueva factura."}}],"summary":"Emite una factura","tags":["Facturas"]}},"/sales/invoices/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de facturas en CSV","tags":["Facturas"]}},"/sales/invoices/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una factura","tags":["Facturas"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"Solicitud de creación de nueva factura.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"due_date":{"type":"string","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"subtotal_discount":{"type":"string","description":"Descuento adicional del documento.","example":"0.00"},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"gratuity":{"type":"string","description":"Valor de propina.","example":"5.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"string","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":"9.00"},"amount":{"type":"string","description":"Monto de la detracción con dos decimales.","example":"1000.00"}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"incoterm":{"type":"string","description":"Código INCOTERM","example":"EXW"},"freight_charge":{"type":"string","description":"Costo del flete.","example":"100.00"},"insurance_charge":{"type":"string","description":"Costo del seguro.","example":"100.00"},"other_charges":{"type":"string","description":"Otros cargos.","example":"100.00"},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"string","description":"Peso bruto de la carga.","example":"0.0"},"net_weight":{"type":"string","description":"Peso neto de la carga.","example":"0.0"},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"string","description":"Total del descuento.","example":"100.00"}},"required":["incoterm","freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda del documento.","example":"PEN"},"total":{"type":"string","description":"Monto total del anticipo (incluye impuestos).","example":"118.00"},"subtotal":{"type":"string","description":"Subtotal del anticipo, sin incluir impuestos.","example":"100.00"}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo: '04' gravado/IGV/exportación, '05' exonerado, '06' inafecto, '20' ISC. Si no se envía, se deriva automáticamente del tipo de operación de las líneas.","example":"05"},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"string","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":"0.03"},"amount":{"type":"string","description":"Monto retenido.","example":"1133.42"},"base_amount":{"type":"string","description":"Base del cálculo de la retención.","example":"37780.81"}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","customer_legal_name","customer_tax_id","customer_tax_id_type","line_items","subtotal","tax","total"],"description":"Solicitud de creación de nueva factura."}}],"summary":"Actualiza una factura","tags":["Facturas"]}},"/sales/invoices/{id}/payments":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[],"summary":"Registra un pago en una factura","tags":["Facturas"]}},"/sales/invoices/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una factura","tags":["Facturas"]}},"/sales/invoices/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una factura a la autoridad tributaria","tags":["Facturas"]}},"/sales/invoices/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"subtotal_discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"subtotal_discount_code":{"type":"string","description":"Código de tipo de descuento adicional.","example":"00"},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"gratuity":{"type":"number","format":"double","description":"Valor de propina.","example":5.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"advance_payments_total":{"type":"number","format":"double","description":"Total de los pagos anticipados.","example":100.0},"advance_payments_subtotal":{"type":"number","format":"double","description":"Subtotal de los pagos anticipados sin impuestos.","example":84.75},"advance_payments_discount_code":{"type":"string","description":"Código SUNAT (Catálogo 53) del descuento global por anticipo aplicado al documento.","example":"05"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de tipos de bienes y servicios sujetos a detracción, disponibles en el catálogo No. 54 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"payment_means_code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos de formas de pago disponibles en el catálogo No. 59 de SUNAT](https://cpe.sunat.gob.pe/sites/default/files/inline-files/anexoV-340-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total del descuento.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"advance_payments":{"type":"array","items":{"type":"object","properties":{"document_number":{"type":"string","description":"Número de documento","example":"E001-196"},"document_type_code":{"type":"string","description":"Código de tipo de documento","example":"ANTICIPO"},"document_status_code":{"type":"string","description":"Código del estado del documento","example":"1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"total":{"type":"number","format":"double","description":"Monto total del anticipo (incluye impuestos).","example":118.00},"subtotal":{"type":"number","format":"double","description":"Subtotal del anticipo, sin incluir impuestos.","example":100.00}},"required":["document_number","document_type_code","document_status_code","currency","total"],"description":"Define los anticipos de pago de la factura."}},"withholdings":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código de retención SUNAT, catálogo 53.","example":"62"},"rate":{"type":"number","format":"double","description":"Factor decimal de retención (por ejemplo 0.03 para 3%).","example":0.03},"amount":{"type":"number","format":"double","description":"Monto retenido.","example":1133.42},"base_amount":{"type":"number","format":"double","description":"Base del cálculo de la retención.","example":37780.81}},"required":["code","amount","base_amount"],"description":"Datos de retención del documento."}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura."},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una factura por email al cliente","tags":["Facturas"]}},"/sales/invoices/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una factura","tags":["Facturas"]}},"/sales/perceptions":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las percepciones","tags":["Percepciones"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"P001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"string","description":"Tasa de la percepción en formato de dos decimales.","example":"1.00"},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"string","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"100.00"},"total_charged_amount":{"type":"string","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":"97.00"},"charged_amount_currency":{"type":"string","description":"Moneda del importe cobrado.","example":"USD"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"F001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2020-01-01"},"affected_document_total_amount":{"type":"string","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":"12323.02"},"affected_document_currency":{"type":"string","description":"Tipo de moneda del documento afectado.","example":"PEN"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2020-01-03"},"amount":{"type":"string","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":"1223.22"},"currency":{"type":"string","description":"Tipo de moneda del pago.","example":"PEN"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"string","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"10.02"},"perception_currency":{"type":"string","description":"Tipo de moneda de la percepción.","example":"PEN"},"perception_date":{"type":"string","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2020-02-02"},"chargable_amount":{"type":"string","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":"10.02"},"chargable_amount_currency":{"type":"string","description":"Tipo de moneda del pago neto.","example":"PEN"},"exchange_rate_source_currency":{"type":"string","description":"Moneda de referencia para el tipo de cambio.","example":"USD"},"exchange_rate_target_currency":{"type":"string","description":"Moneda objetivo para la tasa de cambio.","example":"PEN"},"exchange_rate_calculation_rate":{"type":"string","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":"3.00"},"exchange_rate_date":{"type":"string","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2020-02-02"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency"],"description":"Detalle de documentos afectados por la percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","perception_regime","perception_rate","total","total_charged_amount","charged_amount_currency","line_items"]}}],"summary":"Emite una percepción","tags":["Percepciones"]}},"/sales/perceptions/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de percepciones en CSV","tags":["Percepciones"]}},"/sales/perceptions/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una percepción","tags":["Percepciones"]}},"/sales/perceptions/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una percepción","tags":["Percepciones"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"P001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"string","description":"Tasa de la percepción en formato de dos decimales.","example":"1.00"},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"string","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"100.00"},"total_charged_amount":{"type":"string","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":"97.00"},"charged_amount_currency":{"type":"string","description":"Moneda del importe cobrado.","example":"USD"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"F001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2020-01-01"},"affected_document_total_amount":{"type":"string","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":"12323.02"},"affected_document_currency":{"type":"string","description":"Tipo de moneda del documento afectado.","example":"PEN"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2020-01-03"},"amount":{"type":"string","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":"1223.22"},"currency":{"type":"string","description":"Tipo de moneda del pago.","example":"PEN"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"string","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"10.02"},"perception_currency":{"type":"string","description":"Tipo de moneda de la percepción.","example":"PEN"},"perception_date":{"type":"string","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2020-02-02"},"chargable_amount":{"type":"string","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":"10.02"},"chargable_amount_currency":{"type":"string","description":"Tipo de moneda del pago neto.","example":"PEN"},"exchange_rate_source_currency":{"type":"string","description":"Moneda de referencia para el tipo de cambio.","example":"USD"},"exchange_rate_target_currency":{"type":"string","description":"Moneda objetivo para la tasa de cambio.","example":"PEN"},"exchange_rate_calculation_rate":{"type":"string","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":"3.00"},"exchange_rate_date":{"type":"string","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2020-02-02"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency"],"description":"Detalle de documentos afectados por la percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","perception_regime","perception_rate","total","total_charged_amount","charged_amount_currency","line_items"]}}],"summary":"Actualiza una percepción","tags":["Percepciones"]}},"/sales/perceptions/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una percepción a la autoridad tributaria","tags":["Percepciones"]}},"/sales/perceptions/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"P001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"P001-1"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-perception-void-request"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"datil.rest-api.schemas/series":{"type":"string","description":"Serie del documento","example":"R001"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"perception_regime":{"type":"string","description":"Régimen de la percepción. Ver tabla de Regímenes de Percepción.","example":"01"},"perception_rate":{"type":"number","format":"double","description":"Tasa de la percepción en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total percibido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_charged_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"charged_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"P001-1"},"affected_document_order":{"type":"string","description":"Número de cobro.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_charges":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"perception_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"perception_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"perception_date":{"type":"string","format":"date-time","description":"Fecha de la retención.","example":"2026-10-07T17:29:46Z"},"chargable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la percepción, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"chargable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_charges","perception_amount","perception_currency","perception_date","chargable_amount","chargable_amount_currency","exchange_rate_source_currency","exchange_rate_target_currency","exchange_rate_calculation_rate","exchange_rate_date"],"description":"Lista de ítems de la percepción. Debe tener al menos un ítem."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una percepción."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","number","sequence","currency","country","environment","status","type","datil.rest-api.schemas/series","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","perception_regime","perception_rate","total","total_in_words","total_charged_amount","charged_amount_currency","line_items"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una percepción por email al cliente","tags":["Percepciones"]}},"/sales/perceptions/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una percepción","tags":["Percepciones"]}},"/purchases/invoices":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura de compra."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total descontador.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura de compra."}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las facturas de compra recibidas","tags":["Facturas de compra"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura de compra."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total descontador.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura de compra."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"Registro de nueva factura de compra.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"due_date":{"type":"string","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"vendor_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del proveedor.","example":"pe-ruc"},"vendor_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_telephone":{"type":"string","description":"Teléfono del proveedor.","example":"1234567890"},"vendor_code":{"type":"string","description":"Código de proveedor.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"string","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":"9.00"},"amount":{"type":"string","description":"Monto de la detracción con dos decimales.","example":"1000.00"}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"incoterm":{"type":"string","description":"Código INCOTERM","example":"EXW"},"freight_charge":{"type":"string","description":"Costo del flete.","example":"100.00"},"insurance_charge":{"type":"string","description":"Costo del seguro.","example":"100.00"},"other_charges":{"type":"string","description":"Otros cargos.","example":"100.00"},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"string","description":"Peso bruto de la carga.","example":"0.0"},"net_weight":{"type":"string","description":"Peso neto de la carga.","example":"0.0"},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"string","description":"Total descontador.","example":"100.00"}},"required":["incoterm","freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","vendor_legal_name","vendor_tax_id","vendor_tax_id_type","line_items","subtotal","tax","total"],"description":"Registro de nueva factura de compra."}}],"summary":"Registra una factura de compra","tags":["Facturas de compra"]}},"/purchases/invoices/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de facturas de compra en CSV","tags":["Facturas de compra"]}},"/purchases/invoices/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura de compra."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total descontador.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura de compra."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una factura de compra","tags":["Facturas de compra"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"due_date":{"type":"string","format":"date-time","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"customer_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"customer_commercial_name":{"type":"string","description":"Nombre comercial del cliente.","example":"Jose Mario"},"customer_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"customer_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"customer_telephone":{"type":"string","description":"Teléfono del cliente.","example":"1234567890"},"customer_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"customer_code":{"type":"string","description":"Código de cliente.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"line_items":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"total":{"type":"number","format":"double","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos."},"tax":{"type":"number","format":"double","description":"Impuestos totales de la línea.","example":18.0},"tax_included_unit_price":{"type":"number","format":"double","description":"Precio incluido impuestos","example":118.0},"unit_price":{"type":"number","format":"double","description":"Precio unitario, sin incluir impuestos.","example":100.0},"quantity":{"type":"number","format":"double","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":1.0},"discount":{"type":"number","format":"double","description":"Descuento total de la línea.","example":0.0},"discount_rate":{"type":"number","format":"double","description":"Porcentaje de descuento total de la línea.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":100.0},"subtotal_without_discount":{"type":"number","format":"double","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":100.0},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["order","total","tax","tax_included_unit_price","unit_price","quantity","subtotal","tax_lines","sku","description","price_type_code"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}},"amount_due":{"type":"number","format":"double","description":"Monto pendiente de pago de la factura.","example":0.0},"subtotal":{"type":"number","format":"double","description":"Subtotal de la factura, sin incluir impuestos.","example":100.0},"tax":{"type":"number","format":"double","description":"Total de impuestos de la factura.","example":18.0},"total":{"type":"number","format":"double","description":"Total incluido impuestos y descuentos.","example":118.0},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"amount":{"type":"number","format":"double","description":"Monto de la forma de pago.","example":100.00},"due_date":{"type":"string","format":"date-time","description":"Fecha esperada de pago en formato Epoch.","example":"1791394186"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"credit_notes":{"type":"array","items":{"type":"object","properties":{"total":{"type":"number","format":"double","description":"Monto total de la nota de crédito.","example":10.0},"id":{"type":"string","description":"Identificador de la nota de crédito, con el cual puedes consultarla en Dátil.","example":"123456"},"number":{"type":"string","description":"Número de la nota de crédito relacionada, en el formato requerido por la autoridad tributaria.","example":"NC001-1"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión de la nota de crédito.","example":"1791394186"},"tax_clearance_status":{"type":"string","description":"Estado tributario de la nota de crédito.","example":"cleared"}},"required":["total","id","number","issue_date","tax_clearance_status"],"description":"Referencia a las notas de crédito relacionadas. Estas afectan el saldo pendiente de pago."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2022-01-01T00:00:00Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"F001-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/sales-invoice"},"recipient_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"void_reason":{"type":"string","description":"Razón de la anulación.","example":"Error al emitir el documento."}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","void_reason"],"description":"Respuesta de una solicitud anulación de una factura de compra."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"number","format":"double","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":9.00},"amount":{"type":"number","format":"double","description":"Monto de la detracción con dos decimales.","example":1000.00}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"freight_charge":{"type":"number","format":"double","description":"Costo del flete.","example":100.00},"insurance_charge":{"type":"number","format":"double","description":"Costo del seguro.","example":100.00},"other_charges":{"type":"number","format":"double","description":"Otros cargos.","example":100.00},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"number","format":"double","description":"Peso bruto de la carga.","example":0.0},"net_weight":{"type":"number","format":"double","description":"Peso neto de la carga.","example":0.0},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"number","format":"double","description":"Total descontador.","example":"100.00"}},"required":["freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","number","currency","country","environment","status","type","series","sequence","customer_legal_name","customer_tax_id","customer_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","line_items","tax_lines","subtotal","tax","total","total_in_words"],"description":"Respuesta de una nueva factura de compra."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"Registro de nueva factura de compra.","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"due_date":{"type":"string","description":"Fecha máxima de pago. Debe ser igual o mayor al parámetro `issue_date`","example":"1791394186"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"operation_type":{"type":"string","title":"Válido para Perú","description":"Tipo de operación SUNAT.","example":"01"},"vendor_legal_name":{"type":"string","description":"Nombre del proveedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del proveedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del proveedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del proveedor.","example":"pe-ruc"},"vendor_email":{"type":"string","description":"Email del proveedor al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_telephone":{"type":"string","description":"Teléfono del proveedor.","example":"1234567890"},"vendor_code":{"type":"string","description":"Código de proveedor.","example":"1234"},"waybill_number":{"type":"string","description":"Número de guía de remisión.","example":"1234"},"waybill_code":{"type":"string","description":"Código de guía de remisión.","example":"1234"},"sales_order_number":{"type":"string","description":"Número de orden de venta.","example":"1234"},"purchase_order_number":{"type":"string","description":"Número de orden de compra.","example":"1234"},"line_items":{"type":"array","items":{"type":"object","properties":{"sku":{"type":"string","description":"Código del producto a facturar.","example":"A001"},"item_classification_code":{"type":"string","description":"Código de clasificación del ítem.","example":"1234"},"tariff_heading":{"type":"string","description":"Partida arancelaria","example":"1234"},"description":{"type":"string","description":"Descripción del producto a facturar.","example":"Servicio ABC"},"price_type_code":{"type":"string","title":"Válido para Perú.","description":"Código del tipo de precio del producto. Ver tabla de Tipos de Precio de Perú.","example":"01"},"unit_of_measurement":{"type":"string","description":"Unidad de medida.","example":"KG"},"unit_code":{"type":"string","description":"Código unitario","example":"1"},"tax_included_unit_price":{"type":"string","description":"Precio incluido impuestos","example":"118.00"},"unit_price":{"type":"string","description":"Precio unitario, sin incluir impuestos.","example":"100.00"},"quantity":{"type":"string","description":"Cantidad a facturar. Dátil redondeará la cantidad automáticamente de acuerdo al requerimiento de cada país.","example":"1"},"discount":{"type":"string","description":"Descuento total de la línea.","example":"0.00"},"subtotal_without_discount":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario, sin incluir los descuentos unitarios.","example":"100.00"},"subtotal":{"type":"string","description":"Subtotal de la línea, obtenido de multiplicar la cantidad por el precio unitario.","example":"100.00"},"tax":{"type":"string","description":"Impuestos totales de la línea.","example":"18.00"},"total":{"type":"string","description":"Valor total de la factura, calculada como el subtotal menos los descuentos mas los impuestos.","example":"118.00"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}}},"required":["sku","description","tax_included_unit_price","unit_price","quantity","subtotal","tax","total","tax_lines"],"description":"Lista de ítems de la factura. Debe tener al menos un ítem."}},"tax_lines":{"type":"array","items":{"type":"object","properties":{"tax_rate":{"type":"string","description":"Código de la tarifas de impuestos. Ver Tarifas de Impuestos por país.","example":"pe-igv"},"amount":{"type":"string","description":"Monto del impuesto.","example":"18.00"},"taxable_amount":{"type":"string","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":"100.00"},"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"}},"required":["tax_rate","amount","taxable_amount"],"description":"Líneas de impuestos"}},"subtotal":{"type":"string","description":"Subtotal de la factura, sin incluir impuestos.","example":"100.00"},"tax":{"type":"string","description":"Total de impuestos de la factura.","example":"18.00"},"total":{"type":"string","description":"Total incluido impuestos y descuentos.","example":"118.00"},"note":{"type":"string","description":"Nota con información adicional para la factura.","example":"Gracias por tu compra."},"payment_terms":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"Código identificador de la forma de pago.","example":"Contado"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda de la forma de pago.","example":"PEN"},"amount":{"type":"string","description":"Monto de la forma de pago","example":"100.00"},"due_date":{"type":"string","description":"Fecha esperada de pago en formato Epoch.","example":"2021-08-01"},"description":{"type":"string","description":"Descripción de la condición de pago.","example":"Pago a 90 días."}},"description":"Define los términos de pago de la factura."}},"detraction":{"type":"object","properties":{"bank_account":{"type":"string","description":"Número de cuenta del Banco de la Nación.","example":"123"},"code":{"type":"string","description":"Codigo del bien o producto sujeto a detracción. Revisa los [códigos disponibles en la página web de SUNAT](http://www.sunat.gob.pe/legislacion/superin/2017/anexoVII-117-2017.pdf).","example":"001"},"rate":{"type":"string","description":"Porcentaje de la detracción con dos decimales. Por ejemplo `9.00`.","example":"9.00"},"amount":{"type":"string","description":"Monto de la detracción con dos decimales.","example":"1000.00"}},"required":["bank_account","code","rate","amount"],"title":"Válido para Perú.","description":"Información sobre la detracción en la factura. Las detracciones son un mecanismo para recaudación de impuestos aplicado en Perú. Conocer más sobre las detracciones en la [\npágina web de SUNAT.](https://orientacion.sunat.gob.pe/index.php/empresas-menu/regimen-de-detracciones-del-igv-empresas/como-funcionan-las-detracciones)"},"export":{"type":"object","properties":{"incoterm":{"type":"string","description":"Código INCOTERM","example":"EXW"},"freight_charge":{"type":"string","description":"Costo del flete.","example":"100.00"},"insurance_charge":{"type":"string","description":"Costo del seguro.","example":"100.00"},"other_charges":{"type":"string","description":"Otros cargos.","example":"100.00"},"shipping_method":{"type":"string","description":"Vía de despacho.","example":"Marítimo"},"port_of_loading":{"type":"string","description":"Puerto de embarque.","example":"Callao - Perú"},"port_of_destination":{"type":"string","description":"Puerto de destino.","example":"Barranquilla - Colombia"},"country_of_origin":{"type":"string","description":"País de origen.","example":"Perú"},"gross_weight":{"type":"string","description":"Peso bruto de la carga.","example":"0.0"},"net_weight":{"type":"string","description":"Peso neto de la carga.","example":"0.0"},"gross_weight_unit":{"type":"string","description":"Unidad de medida de peso.","example":"Kg"},"total_discount":{"type":"string","description":"Total descontador.","example":"100.00"}},"required":["incoterm","freight_charge","insurance_charge","other_charges","shipping_method","port_of_loading","port_of_destination","country_of_origin","gross_weight","net_weight","gross_weight_unit","total_discount"],"description":"Información para facturas de exportación."},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","vendor_legal_name","vendor_tax_id","vendor_tax_id_type","line_items","subtotal","tax","total"],"description":"Registro de nueva factura de compra."}}],"summary":"Actualiza una factura de compra","tags":["Facturas de compra"]}},"/purchases/invoices/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una factura","tags":["Facturas de compra"]}},"/purchases/retentions":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"object":{"type":"string","description":"Tipo de objeto","example":"list"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]}},"count":{"type":"number","format":"double","description":"Total de objetos consultados.","example":1},"limit":{"type":"number","format":"double","description":"Límite de cantidad de objetos a consultas. El límite predeterminado es 25.","example":25},"offset":{"type":"number","format":"double","description":"_Offset_ de consulta.","example":0},"total":{"type":"number","format":"double","description":"Total de objetos en la lista.","example":1}},"required":["object","data","count","limit","offset","total"],"description":"Lista de objetos."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Lista las retenciones emitidas","tags":["Retenciones"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"string","description":"Tasa de la retención en formato de dos decimales.","example":"1.00"},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"string","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"100.00"},"total_paid_amount":{"type":"string","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":"97.00"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"F001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2020-01-01"},"affected_document_total_amount":{"type":"string","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":"12323.02"},"affected_document_currency":{"type":"string","description":"Tipo de moneda del documento afectado.","example":"PEN"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2020-01-03"},"amount":{"type":"string","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":"1223.22"},"currency":{"type":"string","description":"Tipo de moneda del pago.","example":"PEN"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"string","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"10.02"},"retention_currency":{"type":"string","description":"Tipo de moneda de la percepción.","example":"PEN"},"retention_date":{"type":"string","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2020-02-02"},"payable_amount":{"type":"string","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":"10.02"},"payable_amount_currency":{"type":"string","description":"Tipo de moneda del pago neto.","example":"PEN"},"exchange_rate_source_currency":{"type":"string","description":"Moneda de referencia para el tipo de cambio.","example":"USD"},"exchange_rate_target_currency":{"type":"string","description":"Moneda objetivo para la tasa de cambio.","example":"PEN"},"exchange_rate_calculation_rate":{"type":"string","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":"3.00"},"exchange_rate_date":{"type":"string","description":"Fecha de cambio","example":"2020-02-02"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency"],"description":"Detalle de documentos afectados por la retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","retention_regime","retention_rate","total","total_paid_amount","line_items"]}}],"summary":"Emite una retención","tags":["Retenciones"]}},"/purchases/retentions/export/csv":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"query","name":"from","description":"Fecha inicial","type":"string","required":false,"example":"2020-01-01"},{"in":"query","name":"to","description":"Fecha final","type":"string","required":false,"example":"2020-01-15"},{"in":"query","name":"tax_clearance_status","description":"Estados de autorización tributaria separados por coma: cleared, rejected, signed, draft o processing","type":"string","required":false,"example":"signed,rejected,draft"},{"in":"query","name":"status","description":"Estados del documento separados por coma: active,processing,void,rejected","type":"string","required":false,"example":"active,processing,void,rejected"}],"summary":"Descarga una lista de retenciones en CSV","tags":["Retenciones"]}},"/purchases/retentions/{id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Consulta una retención","tags":["Retenciones"]},"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch.","example":"1791394186"},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"currency":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"string","description":"Tipo de identificación tributaria del cliente.","example":"pe-ruc"},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"required":["line_1","country"],"description":"Dirección del cliente"},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"}},"description":"Dirección del emisor del documento"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"string","description":"Tasa de la retención en formato de dos decimales.","example":"1.00"},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"string","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"100.00"},"total_paid_amount":{"type":"string","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":"97.00"},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"F001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2020-01-01"},"affected_document_total_amount":{"type":"string","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":"12323.02"},"affected_document_currency":{"type":"string","description":"Tipo de moneda del documento afectado.","example":"PEN"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2020-01-03"},"amount":{"type":"string","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":"1223.22"},"currency":{"type":"string","description":"Tipo de moneda del pago.","example":"PEN"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"string","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":"10.02"},"retention_currency":{"type":"string","description":"Tipo de moneda de la percepción.","example":"PEN"},"retention_date":{"type":"string","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2020-02-02"},"payable_amount":{"type":"string","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":"10.02"},"payable_amount_currency":{"type":"string","description":"Tipo de moneda del pago neto.","example":"PEN"},"exchange_rate_source_currency":{"type":"string","description":"Moneda de referencia para el tipo de cambio.","example":"USD"},"exchange_rate_target_currency":{"type":"string","description":"Moneda objetivo para la tasa de cambio.","example":"PEN"},"exchange_rate_calculation_rate":{"type":"string","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":"3.00"},"exchange_rate_date":{"type":"string","description":"Fecha de cambio","example":"2020-02-02"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency"],"description":"Detalle de documentos afectados por la retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}},"auto_advance":{"type":"boolean","description":"Indica si el documento debe avanzar automáticamente en el flujo de autorización. Por defecto es `true`.","example":true}},"required":["issue_date","series","sequence","currency","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","retention_regime","retention_rate","total","total_paid_amount","line_items"]}}],"summary":"Actualiza una retención","tags":["Retenciones"]}},"/purchases/retentions/{id}/void":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"affected_documents":{"type":"array","items":{"type":"object","properties":{"order":{"type":"number","format":"double","description":"Orden del ítem."},"series":{"type":"string","description":"Serie del documento","example":"F001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"type_code":{"type":"string","description":"Código del tipo de documento.","example":"01"},"customer_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"tax_lines":{"type":"array","items":{"type":"object","properties":{"exemption_reason_code":{"type":"string","title":"Válido para Perú.","description":"Códigos de afectación de impuestos.","example":"10"},"taxable_amount":{"type":"number","format":"double","description":"Monto de base imponible sobre el cual se calcula el valor del impuesto.","example":18.0},"amount":{"type":"number","format":"double","description":"Monto del impuesto.","example":18.0},"tax_rate":{"type":"object","properties":{"type":{"type":"string","description":"Código del tipo de impuesto.","example":"pe-igv"},"name":{"type":"string","description":"Nombre del tipo de impuesto.","example":"IGV"},"category-code":{"type":"string","description":"Código de la categoría del impuesto, establecido por la autoridad tributaria.","example":"VAT"},"code":{"type":"string","description":"Código de la tarifa del impuesto.","example":"1000"},"percentage":{"type":"number","format":"double","description":"Tarifa del impuesto en porcentaje.","example":18.0}},"required":["type","name","category-code","code","percentage"]}},"required":["taxable_amount","amount","tax_rate"],"description":"Líneas de impuestos"}}},"required":["order","series","sequence","type_code"],"description":"Lista de documentos anulados."}},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"reference_date":{"type":"string","format":"date-time","description":"Corresponde a la fecha de emisión de los documentos anulados.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento","example":"RA-20201001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20201001-1"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","affected_documents","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","issue_date","reference_date","series","sequence","number","country","environment","type","void_reason"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"},{"in":"body","name":"body","description":"","required":true,"schema":{"type":"object","properties":{"issue_date":{"type":"string","description":"Fecha de emisión en formato Epoch o ISO 8601.","example":"1791394186"},"sequence":{"type":"string","description":"Secuencia numérica del documento.","example":"1"},"void_reason":{"type":"string","description":"Razón por la cual se anula el documento.","example":"Error de facturación."}},"required":["issue_date","sequence","void_reason"]}}],"summary":"Anula una retención","tags":["Retenciones"]}},"/purchases/retentions/{id}/send-to-tax-authority":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una retención a la autoridad tributaria","tags":["Retenciones"]}},"/purchases/retentions/{id}/send-email":{"post":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339."},"series":{"type":"string","description":"Serie del documento","example":"R001"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"status":{"enum":["draft","active","void"],"description":"Estatus del documento\n\n  **draft**: Borrador\n  **active**: Activo\n  **void**: Anulado."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del emisor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del emisor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del emisor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"retention_regime":{"type":"string","description":"Régimen de la retención. Ver tabla de Regímenes de Retención.","example":"01"},"retention_rate":{"type":"number","format":"double","description":"Tasa de la retención en formato de dos decimales.","example":1.00},"note":{"type":"string","description":"Nota con información adicional para el documento.","example":"Nota sobre el documento"},"total":{"type":"number","format":"double","description":"Importe total retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":100.00},"total_in_words":{"type":"string","description":"Total incluido impuestos y descuentos, en palabras.","example":"Ciento dieciocho soles."},"total_paid_amount":{"type":"number","format":"double","description":"Importe total cobrado, en formato de doce posiciones numéricas con hasta dos decimales.","example":97.00},"line_items":{"type":"array","items":{"type":"object","properties":{"affected_document_type":{"type":"string","description":"Tipo del documento afectado. Ver Tipos de Documents.","example":"01"},"affected_document_number":{"type":"string","description":"Número del documento afectado. Ver la especificación de numeración de documentos.","example":"R001-1"},"affected_document_order":{"type":"string","description":"Número de pago.","example":"1"},"affected_document_issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento afectado en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"affected_document_total_amount":{"type":"number","format":"double","description":"Importe total del documento afectado en formato de doce posiciones numéricas con hasta dos decimales.","example":12323.02},"affected_document_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"affected_document_payments":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date-time","description":"Fecha de pago del documento afectado, en formato YYYY-MM-DD","example":"2026-10-07T17:29:46Z"},"amount":{"type":"number","format":"double","description":"Importe total del cargo de la percepción, en formato de doce posiciones numéricas con hasta dos decimales.","example":1223.22},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"}},"required":["date","amount","currency"],"description":"Detalle de los cargos del documento afectado."}},"retention_amount":{"type":"number","format":"double","description":"Importe retenido, en formato de doce posiciones numéricas con hasta dos decimales.","example":10.02},"retention_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"retention_date":{"type":"string","format":"date-time","description":"Fecha de la retención en formato YYYY-MM-DD.","example":"2026-10-07T17:29:46Z"},"payable_amount":{"type":"number","format":"double","description":"Valor neto a cobrar por la retención, en formato de doce posiciones numéricas, con hasta dos decimales.","example":10.02},"payable_amount_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_source_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_target_currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"exchange_rate_calculation_rate":{"type":"number","format":"double","description":"El factor aplicado a la moneda de origen para calcular la moneda de destino (Tipo de cambio)","example":3.00},"exchange_rate_date":{"type":"string","format":"date-time","description":"Fecha de cambio","example":"2026-10-07T17:29:46Z"}},"required":["affected_document_type","affected_document_number","affected_document_issue_date","affected_document_total_amount","affected_document_currency","affected_document_payments"],"description":"Lista de ítems de la retención."}},"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"issue_date":{"type":"string","format":"date-time","description":"Fecha de emisión del documento, en formato RFC3339.","example":"2026-10-07T17:29:46Z"},"series":{"type":"string","description":"Serie del documento.","example":"F001"},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"FC01-1"},"currency":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 4217 de la moneda.","example":"PEN"},"name":{"type":"string","description":"Nombre de la moneda.","example":"Soles Peruanos"},"symbol":{"type":"string","description":"Símbolo de la moneda","example":"S/."}},"required":["code","name","symbol"],"description":"Moneda"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"},"environment":{"enum":["live","test"],"description":"Tipo de ambiente del documento.\n\n  **live**: Ambiente de producción.\n  **test**: Ambiente de pruebas."},"type":{"type":"string","description":"Tipo de documento.","example":"pe/purchase-retention-void-request"},"recipient_legal_name":{"type":"string","description":"Nombre del cliente.","example":"Jose Mario"},"recipient_tax_id":{"type":"string","description":"Identificación tributaria del cliente.","example":"20601595665"},"recipient_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"recipient_email":{"type":"string","description":"Email del cliente al cual Dátil envía notificaciones sobre la factura. Si no lo envías, Dátil no enviará ninguna notificación.","example":"prueba@prueba.com"},"recipient_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"vendor_legal_name":{"type":"string","description":"Nombre legal del vendedor.","example":"Jose Mario"},"vendor_commercial_name":{"type":"string","description":"Nombre comercial del vendedor.","example":"Jose Mario"},"vendor_tax_id":{"type":"string","description":"Identificación tributaria del vendedor.","example":"20601595665"},"vendor_tax_id_type":{"type":"object","properties":{"type":{"type":"string","description":"Código de tipo de identificación.","example":"pe-ruc"},"code":{"type":"string","description":"Código de tipo identificación establecido por la autoridad tributaria.","example":"6"},"name":{"type":"string","description":"Nombre del tipo de identificación.","example":"RUC"}},"required":["type","code","name"],"description":"Tipo de identificación tributaria del cliente."},"vendor_address":{"type":"object","properties":{"line_1":{"type":"string","description":"Calle y número de la dirección.","example":"Calle A"},"locality":{"type":"string","description":"Localidad o distrito","example":"Lima"},"administrative_district_level_1":{"type":"string","description":"Provincia o estado","example":"Miraflores"},"administrative_district_level_2":{"type":"string","description":"Ciudad","example":"Lima"},"city":{"type":"string","description":"Ciudad","example":"Lima"},"province":{"type":"string","description":"Provincia","example":"Lima"},"ubigeo":{"type":"string","description":"Código de ubicación geográfica.","title":"Válido para Perú."},"tax_code":{"type":"string","description":"Código tributario de la dirección.","example":"0000"},"country":{"type":"object","properties":{"code":{"type":"string","description":"Código ISO 3166 Alpha 2 del país.","example":"PE"},"name":{"type":"string","description":"Nombre del país.","example":"Perú"}},"required":["code","name"],"description":"País"}},"required":["line_1","locality","administrative_district_level_1","administrative_district_level_2","country"],"description":"Dirección del cliente"},"tax_clearance":{"type":"object","properties":{"void_requests":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Identificador único del documento, generado por Dátil. Te sugerimos guardarlo en tu base de datos para que luego puedas consultar su estado.","example":"81wxc0qk5cgz4a7z3550a3art3"},"type":{"type":"string","description":"Tipo de documento.","example":"pe/void-request"},"series":{"type":"string","description":"Serie del documento","example":"RA-20210315"},"sequence":{"type":"number","format":"double","description":"Secuencia numérica del documento.","example":1},"number":{"type":"string","description":"Número de documento, generado en el siguiente formato: `series`-`sequence`","example":"RA-20210315-3"},"tax_clearance":{"type":"object","properties":{"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."}},"required":["id","type","series","sequence","number"],"description":"Información del envío de una solicitud de anulación."}},"status":{"enum":["draft","signed","processing","cleared","rejected"],"description":"Estado del envío electrónico del documento. Este es actualizado automáticamente por Dátil conforme avanza el proceso de envío a la autoridad tributaria.\n\n **draft**: El documento está en borrador. Este es el estado por defecto cuando se crea un nuevo documento.\n\n **signed**: El documento ha sido firmado electrónicamente y puede ser enviado a la autoridad tributaria.\n\n **cleared**: El documento fue aceptado o autorizado por la autoridad tributaria.\n\n **rejected**: El documento fue rechazado por la autoridad tributaria.","example":"cleared"},"status_description":{"type":"string","description":"Descripción del estado electrónico del documento en la autoridad tributaria, generado por el sistema de esa institución.","example":"ACEPTADO"},"status_code":{"type":"string","description":"Código del estado electrónico del documento en la autoridad tributaria. Ver la tabla de códigos por país.","example":"0"},"ticket":{"type":"string","description":"Número de ticket que permite consultar el estado de un documento o resumen en proceso por parte de la autoridad tributaria.","example":"1234567890"},"date":{"type":"string","format":"date-time","description":"Fecha de autorización o aceptación del documento.","example":"1791394186"},"message":{"type":"string","description":"Mensaje de la autoridad tributaria sobre la aceptación o rechazo del documento.","example":"El documento ha sido aceptado."},"ack_xml":{"type":"string","description":"XML de acuse de recibo de la [malli.util :as mu]autoridad tributaria","example":"<xml></xml>"},"qr_data":{"type":"string","description":"Información para generar un código QR con información del documento conforme a la normativa de cada autoridad tributaria.","example":"20602224886|6|F002|F002-29|1800.00|11800.00|02/10/2020|6|20877294591|"},"xml":{"type":"string","description":"XML del documento.","example":"https://api.datil.com/documents/1234/xml"},"pdf":{"type":"string","description":"PDF del documento.","example":"https://api.datil.com/p/1234"},"warnings":{"type":"array","items":{"type":"object","properties":{"status_code":{"type":"string","description":"Código de la advertencia.","example":"0000"},"message":{"type":"string","description":"Descripción de la advertencia.","example":"Documento de pruebas"}},"required":["status_code","message"],"description":"Advertencias generadas por la autoridad tributaria."}}},"required":["status"],"description":"Información del envío electrónico del documento a la autoridad tributaria."},"voided_documents":{"type":"array","items":{"type":"object","properties":{"number":{"type":"string","description":"Número del documento.","example":"R001-1"},"series":{"type":"string","description":"Serie del documento.","example":"R001"},"document_type":{"type":"string","description":"Código tributario del tipo de documento.","example":"01"},"sequence":{"type":"number","format":"double","description":"Secuencia del documento.","example":1},"void_reason":{"type":"string","description":"Razon de la anulación.","example":"Anulación por error en la información."}},"required":["number","series","document_type","sequence","void_reason"],"description":"Atributos seleccionados del documento anulado."}}},"required":["id","issue_date","series","number","currency","country","environment","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","voided_documents"],"description":"Respuesta de una solicitud anulación de una retención."}},"custom_fields":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"Nombre del dato adicional","example":"Cedula del Pasajero"},"value":{"type":"string","description":"Valor del dato adicional","example":"1234556"},"code":{"type":"string","description":"Código de sistema","example":"3001"}},"required":["name","value"],"description":"Datos adicionales del documento"}},"notes":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string","description":"Texto de la nota","example":"Documento tributario"},"code":{"type":"string","description":"Código de impuestos de la nota","example":"2008"}},"required":["text"],"description":"Notas del documento"}}},"required":["id","issue_date","series","sequence","currency","country","environment","status","type","recipient_legal_name","recipient_tax_id","recipient_tax_id_type","vendor_legal_name","vendor_commercial_name","vendor_tax_id","vendor_tax_id_type","retention_regime","retention_rate","total","total_in_words","total_paid_amount","line_items"]},"description":""},"404":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Envia una retención por email al cliente","tags":["Retenciones"]}},"/purchases/retentions/{id}/xml":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"xml":{"type":"string","description":"XML del documento.","example":"<xml></xml>"}},"required":["xml"]},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"id","description":"Identificador único del documento, generado por Dátil.","type":"string","required":true,"example":"fgkz4hx4kgjd294v9wgmkewbat"}],"summary":"Descarga el XML de una retención","tags":["Retenciones"]}},"/public-data/tax-entity/{tax-id-type}/{tax-id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"200":{"schema":{"type":"object","properties":{"type":{"type":"string","description":"Tipo de Entidad Tributaria","example":"Persona Natural"},"required_accounting":{"type":"boolean","description":"Requiere Contabilidad","example":false},"tax_id_type":{"type":"object","properties":{}},"main_location":{"type":"object","properties":{"address":{"type":"object","properties":{}}},"required":["address"]},"tax_id":{"type":"string","description":"Identificación tributaria.","example":"0993214563001"},"locations":{"type":"array","items":{"type":"object","properties":{"address":{"type":"object","properties":{}}},"required":["address"]}},"status":{"type":"string","description":"Estado de la entidad tributaria","example":"Activo"},"class":{"type":"string","description":"Clase Contribuyente de la entidad tributaria","example":"Otro"},"commercial_name":{"type":"string","description":"Nombre comercial de la entidad tributaria","example":""},"legal_name":{"type":"string","description":"Nombre legal de la entidad tributaria","example":"Maruri Celi Otilia Victoria"},"core_business":{"type":"string","description":"Actividad económica principal de la entidad tributaria","example":"Actividades de Alquiler de Locales Comerciales"}},"required":["type","required_accounting","tax_id_type","main_location","tax_id","locations","status","class","commercial_name","legal_name","core_business"],"description":"Entidad Tributaria"},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"tax-id","description":"Identificación tributaria.","type":"string","required":true,"example":"0993214563001"}],"summary":"Información pública ","tags":["Entidades tributarias"]}},"/public-data/tax-entity/{tax-id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"tax-id","description":"Identificación tributaria.","type":"string","required":true,"example":"0993214563001"}],"summary":"Información pública sobre la entidad tributaria.","tags":["Entidades tributarias"]}},"/public-data/tax-person/{tax-id}":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[{"in":"path","name":"tax-id","description":"Cédula de identidad.","type":"string","required":true,"example":"0993214563"}],"summary":"Información pública sobre la persona natural.","tags":["Personas Naturales"]}},"/authorize-api-request":{"get":{"responses":{"400":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"401":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"403":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"408":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""},"500":{"schema":{"type":"object","properties":{"type":{"enum":["invalid_request_error","api_error","authentication_error","rate_limit_error"],"description":"Tipo de error. Puede ser uno de los siguientes: `invalid_request_error`, `api_error`, `authentication_error` or `rate_limit_error`"},"message":{"type":"string","description":"Mensaje con una descripción sobre la causa del error."},"params":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"},"description":"Mensajes con una descripción sobre el error.","example":["missing parameter issue_date"]},"description":"Lista de parámetros con errores."}},"required":["type","message"],"description":"Formato de error."},"description":""}},"consumes":["application/json"],"produces":["application/json"],"parameters":[]}}}}