{"openapi":"3.0.3","info":{"title":"HACHEDEV — API de facturación electrónica SUNAT","version":"1.2.0","description":"Emite facturas, boletas, notas de crédito y débito y guías de remisión a SUNAT.\n\nCada token pertenece a una empresa; mientras la empresa esté en modo beta los comprobantes van al entorno de pruebas de SUNAT. Al emitir, la API responde HTTP 200 aunque SUNAT rechace el comprobante: revisa `success` y `estado`. Documentación completa: https://facpro.hachedev.online/docs"},"servers":[{"url":"https://facpro.hachedev.online/api/v1","description":"Versión 1"}],"security":[{"token":[]}],"tags":[{"name":"Empresa"},{"name":"Consultas"},{"name":"Catálogos"},{"name":"Panel"},{"name":"SIRE"},{"name":"Clientes y productos"},{"name":"Inventario"},{"name":"Cotizaciones"},{"name":"Notas de venta"},{"name":"Facturas y boletas"},{"name":"Notas"},{"name":"Anulaciones"},{"name":"Guías de remisión"},{"name":"Retenciones"},{"name":"Percepciones"},{"name":"Cobranzas"},{"name":"Comprobantes"}],"paths":{"/company":{"get":{"tags":["Empresa"],"summary":"Empresa del token, entorno y series","operationId":"getCompany","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/lookup/ruc/{ruc}":{"get":{"tags":["Consultas"],"summary":"Consultar RUC","operationId":"getLookupRucRuc","parameters":[{"name":"ruc","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/catalogs":{"get":{"tags":["Catálogos"],"summary":"Catálogos de SUNAT (unidades, afectación, monedas, motivos…)","operationId":"getCatalogs","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/catalogs/ubigeos":{"get":{"tags":["Catálogos"],"summary":"Buscar ubigeos","operationId":"getCatalogsUbigeos","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"departamento","in":"query","required":false,"schema":{"type":"string"}},{"name":"provincia","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/catalogs/sunat-products":{"get":{"tags":["Catálogos"],"summary":"Buscar códigos de producto SUNAT (UNSPSC) o navegar por niveles","operationId":"getCatalogsSunatProducts","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"nivel","in":"query","required":false,"schema":{"type":"string"}},{"name":"padre","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/catalogs/sunat-products/{codigo}":{"get":{"tags":["Catálogos"],"summary":"Ver un código de producto SUNAT con su jerarquía","operationId":"getCatalogsSunatProductsCodigo","parameters":[{"name":"codigo","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/dashboard":{"get":{"tags":["Panel"],"summary":"Indicadores de ventas, estados SUNAT, cobranzas y stock","operationId":"getDashboard","description":"Permiso del token: `documents`.","parameters":[{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sire/reconciliations":{"get":{"tags":["SIRE"],"summary":"Listar conciliaciones con la propuesta del Registro de Ventas","operationId":"getSireReconciliations","description":"Permiso del token: `documents`.","parameters":[{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["SIRE"],"summary":"Conciliar un periodo (con el archivo de la propuesta o descargándola con la API SIRE)","operationId":"postSireReconciliations","description":"Permiso del token: `documents`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"periodo":"202610"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sire/reconciliations/{reconciliation}":{"get":{"tags":["SIRE"],"summary":"Ver una conciliación con sus diferencias","operationId":"getSireReconciliationsReconciliation","description":"Permiso del token: `documents`.","parameters":[{"name":"reconciliation","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sire/reconciliations/{reconciliation}/refresh":{"post":{"tags":["SIRE"],"summary":"Volver a consultar en SUNAT una conciliación en proceso","operationId":"postSireReconciliationsReconciliationRefresh","description":"Permiso del token: `documents`.","parameters":[{"name":"reconciliation","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers":{"get":{"tags":["Clientes y productos"],"summary":"Listar clientes","operationId":"getCustomers","description":"Permiso del token: `catalog`.","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"numDoc","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Clientes y productos"],"summary":"Registrar cliente","operationId":"postCustomers","description":"Permiso del token: `catalog`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA","direccion":"AV. MORRO SOLAR 1086","email":"compras@cliente.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/customers/{customer}":{"get":{"tags":["Clientes y productos"],"summary":"Ver cliente","operationId":"getCustomersCustomer","description":"Permiso del token: `catalog`.","parameters":[{"name":"customer","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Clientes y productos"],"summary":"Actualizar cliente","operationId":"putCustomersCustomer","description":"Permiso del token: `catalog`.","parameters":[{"name":"customer","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"nuevo@cliente.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Clientes y productos"],"summary":"Eliminar cliente","operationId":"deleteCustomersCustomer","description":"Permiso del token: `catalog`.","parameters":[{"name":"customer","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products":{"get":{"tags":["Clientes y productos"],"summary":"Listar productos","operationId":"getProducts","description":"Permiso del token: `catalog`.","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"codigo","in":"query","required":false,"schema":{"type":"string"}},{"name":"bajoStock","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Clientes y productos"],"summary":"Registrar producto","operationId":"postProducts","description":"Permiso del token: `catalog`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","precio":59,"tipAfeIgv":"10","controlaStock":true,"stockInicial":100,"stockMinimo":10,"costo":35}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products/{product}":{"get":{"tags":["Clientes y productos"],"summary":"Ver producto","operationId":"getProductsProduct","description":"Permiso del token: `catalog`.","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Clientes y productos"],"summary":"Actualizar producto","operationId":"putProductsProduct","description":"Permiso del token: `catalog`.","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"precio":62.5}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Clientes y productos"],"summary":"Eliminar producto","operationId":"deleteProductsProduct","description":"Permiso del token: `catalog`.","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inventory":{"get":{"tags":["Inventario"],"summary":"Resumen de stock y productos con stock bajo","operationId":"getInventory","description":"Permiso del token: `inventory`.","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/inventory/movements":{"get":{"tags":["Inventario"],"summary":"Kardex de la empresa","operationId":"getInventoryMovements","description":"Permiso del token: `inventory`.","parameters":[{"name":"tipo","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products/{product}/movements":{"get":{"tags":["Inventario"],"summary":"Kardex de un producto","operationId":"getProductsProductMovements","description":"Permiso del token: `inventory`.","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"integer"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/products/{product}/adjust":{"post":{"tags":["Inventario"],"summary":"Ajustar stock (cantidad suma o resta; stock fija el conteo)","operationId":"postProductsProductAdjust","description":"Permiso del token: `inventory`.","parameters":[{"name":"product","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"stock":48,"motivo":"INVENTARIO FISICO"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/purchases":{"get":{"tags":["Inventario"],"summary":"Listar compras","operationId":"getPurchases","description":"Permiso del token: `inventory`.","parameters":[{"name":"proveedor","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Inventario"],"summary":"Registrar compra (suma stock y actualiza el costo)","operationId":"postPurchases","description":"Permiso del token: `inventory`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"proveedor":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"tipoDoc":"01","serie":"F001","numero":"4521","fecha":"2026-10-15","items":[{"codProducto":"P001","cantidad":50,"costo":35}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/purchases/{purchase}":{"get":{"tags":["Inventario"],"summary":"Ver compra","operationId":"getPurchasesPurchase","description":"Permiso del token: `inventory`.","parameters":[{"name":"purchase","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"delete":{"tags":["Inventario"],"summary":"Eliminar compra (revierte el stock)","operationId":"deletePurchasesPurchase","description":"Permiso del token: `inventory`.","parameters":[{"name":"purchase","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes":{"get":{"tags":["Cotizaciones"],"summary":"Listar (cotización)","operationId":"getQuotes","description":"Permiso del token: `sales`.","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"estado","in":"query","required":false,"schema":{"type":"string"}},{"name":"cliente","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Cotizaciones"],"summary":"Crear cotización","operationId":"postQuotes","description":"Permiso del token: `sales`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"items":[{"codProducto":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2,"precio":59,"tipAfeIgv":"10"}],"observacion":"ENTREGA EN 48 HORAS"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{saleDocument}":{"get":{"tags":["Cotizaciones"],"summary":"Ver cotización","operationId":"getQuotesSaleDocument","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Cotizaciones"],"summary":"Modificar cotización","operationId":"putQuotesSaleDocument","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"items":[{"codProducto":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2,"precio":59,"tipAfeIgv":"10"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{saleDocument}/status":{"put":{"tags":["Cotizaciones"],"summary":"Cambiar estado de la cotización","operationId":"putQuotesSaleDocumentStatus","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"estado":"aceptada"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{saleDocument}/convert":{"post":{"tags":["Cotizaciones"],"summary":"Convertir la cotización en factura o boleta","operationId":"postQuotesSaleDocumentConvert","description":"Permiso del token: `sales, invoices`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"tipoDoc":"01","serie":"F001","formaPago":"Contado"}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/quotes/{saleDocument}/pdf":{"get":{"tags":["Cotizaciones"],"summary":"PDF de la cotización","operationId":"getQuotesSaleDocumentPdf","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sale-notes":{"get":{"tags":["Notas de venta"],"summary":"Listar (nota de venta)","operationId":"getSaleNotes","description":"Permiso del token: `sales`.","parameters":[{"name":"buscar","in":"query","required":false,"schema":{"type":"string"}},{"name":"estado","in":"query","required":false,"schema":{"type":"string"}},{"name":"cliente","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Notas de venta"],"summary":"Crear nota de venta","operationId":"postSaleNotes","description":"Permiso del token: `sales`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"items":[{"codProducto":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2,"precio":59,"tipAfeIgv":"10"}],"observacion":"ENTREGA EN 48 HORAS"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sale-notes/{saleDocument}":{"get":{"tags":["Notas de venta"],"summary":"Ver nota de venta","operationId":"getSaleNotesSaleDocument","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"put":{"tags":["Notas de venta"],"summary":"Modificar nota de venta","operationId":"putSaleNotesSaleDocument","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"items":[{"codProducto":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2,"precio":59,"tipAfeIgv":"10"}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sale-notes/{saleDocument}/status":{"put":{"tags":["Notas de venta"],"summary":"Cambiar estado de la nota de venta","operationId":"putSaleNotesSaleDocumentStatus","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"estado":"anulada"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sale-notes/{saleDocument}/convert":{"post":{"tags":["Notas de venta"],"summary":"Convertir la nota de venta en factura o boleta","operationId":"postSaleNotesSaleDocumentConvert","description":"Permiso del token: `sales, invoices`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"tipoDoc":"01","serie":"F001","formaPago":"Contado"}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/sale-notes/{saleDocument}/pdf":{"get":{"tags":["Notas de venta"],"summary":"PDF de la nota de venta","operationId":"getSaleNotesSaleDocumentPdf","description":"Permiso del token: `sales`.","parameters":[{"name":"saleDocument","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/lookup/dni/{dni}":{"get":{"tags":["Consultas"],"summary":"Consultar DNI","operationId":"getLookupDniDni","parameters":[{"name":"dni","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/lookup/cpe":{"post":{"tags":["Consultas"],"summary":"Validar en SUNAT un comprobante de cualquier emisor","operationId":"postLookupCpe","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"ruc":"20100070970","tipoDoc":"01","serie":"F001","numero":4521,"fecha":"2026-10-10","monto":1180}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/send":{"post":{"tags":["Facturas y boletas"],"summary":"Emitir factura o boleta","operationId":"postInvoicesSend","description":"Permiso del token: `invoices`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoice"},"examples":{"factura":{"summary":"Factura","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"boleta":{"summary":"Boleta de venta","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"03","serie":"B001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipoMoneda":"PEN","client":{"tipoDoc":"1","numDoc":"12345678","rznSocial":"JUAN PEREZ GARCIA"},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"factura-credito":{"summary":"Factura al crédito","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Credito","monto":236.0,"moneda":"PEN"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}],"cuotas":[{"moneda":"PEN","monto":118.0,"fechaPago":"2026-11-08T00:00:00-05:00"},{"moneda":"PEN","monto":118.0,"fechaPago":"2026-12-08T00:00:00-05:00"}]}},"factura-exonerada":{"summary":"Factura exonerada","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoIGV":0,"totalImpuestos":0,"valorVenta":100.0,"subTotal":100.0,"mtoImpVenta":100.0,"details":[{"codProducto":"L001","unidad":"NIU","cantidad":2,"descripcion":"LIBRO DE MATEMÁTICAS","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":0,"igv":0,"tipAfeIgv":"20","totalImpuestos":0,"mtoValorVenta":100.0,"mtoPrecioUnitario":50.0}],"legends":[{"code":"1000","value":"SON CIEN CON 00/100 SOLES"}],"mtoOperExoneradas":100.0}},"factura-gratuita":{"summary":"Factura con bonificación","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"P003","unidad":"NIU","cantidad":1,"descripcion":"PRODUCTO DE REGALO","mtoValorUnitario":0,"mtoValorGratuito":10.0,"mtoBaseIgv":10.0,"porcentajeIgv":18,"igv":1.8000000000000000444089209850062616169452667236328125,"tipAfeIgv":"15","totalImpuestos":1.8000000000000000444089209850062616169452667236328125,"mtoValorVenta":10.0,"mtoPrecioUnitario":0}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"},{"code":"1002","value":"TRANSFERENCIA GRATUITA DE UN BIEN Y/O SERVICIO PRESTADO GRATUITAMENTE"}],"mtoOperGratuitas":10.0,"mtoIGVGratuitas":1.8000000000000000444089209850062616169452667236328125}},"factura-isc":{"summary":"Factura con ISC","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":41.39999999999999857891452847979962825775146484375,"totalImpuestos":71.400000000000005684341886080801486968994140625,"valorVenta":200.0,"subTotal":271.3999999999999772626324556767940521240234375,"mtoImpVenta":271.3999999999999772626324556767940521240234375,"details":[{"codProducto":"C001","unidad":"NIU","cantidad":2,"descripcion":"CERVEZA 620 ML","mtoValorUnitario":100.0,"mtoBaseIsc":200.0,"porcentajeIsc":15,"isc":30.0,"tipSisIsc":"01","mtoBaseIgv":230.0,"porcentajeIgv":18,"igv":41.39999999999999857891452847979962825775146484375,"tipAfeIgv":"10","totalImpuestos":71.400000000000005684341886080801486968994140625,"mtoValorVenta":200.0,"mtoPrecioUnitario":135.69999999999998863131622783839702606201171875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS SETENTA Y UNO CON 40/100 SOLES"}],"mtoBaseIsc":200.0,"mtoISC":30.0}},"factura-ivap":{"summary":"Factura con IVAP","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"totalImpuestos":8.0,"valorVenta":200.0,"subTotal":208.0,"mtoImpVenta":208.0,"details":[{"codProducto":"A001","unidad":"KGM","cantidad":50,"descripcion":"ARROZ PILADO","mtoValorUnitario":4.0,"mtoBaseIgv":200.0,"porcentajeIgv":4,"igv":8.0,"tipAfeIgv":"17","totalImpuestos":8.0,"mtoValorVenta":200.0,"mtoPrecioUnitario":4.160000000000000142108547152020037174224853515625}],"legends":[{"code":"1000","value":"SON DOSCIENTOS OCHO CON 00/100 SOLES"},{"code":"2007","value":"Operación sujeta al IVAP"}],"mtoBaseIvap":200.0,"mtoIvap":8.0}},"factura-icbper":{"summary":"Factura con ICBPER","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.19999999999998863131622783839702606201171875,"mtoIGV":36.03999999999999914734871708787977695465087890625,"totalImpuestos":37.03999999999999914734871708787977695465087890625,"valorVenta":200.19999999999998863131622783839702606201171875,"subTotal":237.240000000000009094947017729282379150390625,"mtoImpVenta":237.240000000000009094947017729282379150390625,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"BOL01","unidad":"NIU","cantidad":2,"descripcion":"BOLSA DE PLÁSTICO","mtoValorUnitario":0.1000000000000000055511151231257827021181583404541015625,"mtoBaseIgv":0.200000000000000011102230246251565404236316680908203125,"porcentajeIgv":18,"igv":0.040000000000000000832667268468867405317723751068115234375,"tipAfeIgv":"10","icbper":1.0,"factorIcbper":0.5,"totalImpuestos":1.04000000000000003552713678800500929355621337890625,"mtoValorVenta":0.200000000000000011102230246251565404236316680908203125,"mtoPrecioUnitario":0.61999999999999999555910790149937383830547332763671875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SIETE CON 24/100 SOLES"}],"icbper":1.0}},"factura-detraccion":{"summary":"Factura con detracción","value":{"ublVersion":"2.1","tipoOperacion":"1001","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":1000.0,"mtoIGV":180.0,"totalImpuestos":180.0,"valorVenta":1000.0,"subTotal":1180.0,"mtoImpVenta":1180.0,"details":[{"codProducto":"S001","unidad":"ZZ","cantidad":1.0,"descripcion":"SERVICIO DE MANTENIMIENTO","mtoValorUnitario":1000.0,"mtoBaseIgv":1000.0,"porcentajeIgv":18,"igv":180.0,"tipAfeIgv":"10","totalImpuestos":180.0,"mtoValorVenta":1000.0,"mtoPrecioUnitario":1180.0}],"legends":[{"code":"1000","value":"SON MIL CIENTO OCHENTA CON 00/100 SOLES"},{"code":"2006","value":"Operación sujeta a detracción"}],"detraccion":{"codBienDetraccion":"022","codMedioPago":"001","ctaBanco":"00-000-000000","percent":12,"mount":141.599999999999994315658113919198513031005859375}}}}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/xml":{"post":{"tags":["Facturas y boletas"],"summary":"XML firmado sin enviar","operationId":"postInvoicesXml","description":"Permiso del token: `invoices`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoice"},"examples":{"factura":{"summary":"Factura","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"boleta":{"summary":"Boleta de venta","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"03","serie":"B001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipoMoneda":"PEN","client":{"tipoDoc":"1","numDoc":"12345678","rznSocial":"JUAN PEREZ GARCIA"},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"factura-credito":{"summary":"Factura al crédito","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Credito","monto":236.0,"moneda":"PEN"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}],"cuotas":[{"moneda":"PEN","monto":118.0,"fechaPago":"2026-11-08T00:00:00-05:00"},{"moneda":"PEN","monto":118.0,"fechaPago":"2026-12-08T00:00:00-05:00"}]}},"factura-exonerada":{"summary":"Factura exonerada","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoIGV":0,"totalImpuestos":0,"valorVenta":100.0,"subTotal":100.0,"mtoImpVenta":100.0,"details":[{"codProducto":"L001","unidad":"NIU","cantidad":2,"descripcion":"LIBRO DE MATEMÁTICAS","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":0,"igv":0,"tipAfeIgv":"20","totalImpuestos":0,"mtoValorVenta":100.0,"mtoPrecioUnitario":50.0}],"legends":[{"code":"1000","value":"SON CIEN CON 00/100 SOLES"}],"mtoOperExoneradas":100.0}},"factura-gratuita":{"summary":"Factura con bonificación","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"P003","unidad":"NIU","cantidad":1,"descripcion":"PRODUCTO DE REGALO","mtoValorUnitario":0,"mtoValorGratuito":10.0,"mtoBaseIgv":10.0,"porcentajeIgv":18,"igv":1.8000000000000000444089209850062616169452667236328125,"tipAfeIgv":"15","totalImpuestos":1.8000000000000000444089209850062616169452667236328125,"mtoValorVenta":10.0,"mtoPrecioUnitario":0}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"},{"code":"1002","value":"TRANSFERENCIA GRATUITA DE UN BIEN Y/O SERVICIO PRESTADO GRATUITAMENTE"}],"mtoOperGratuitas":10.0,"mtoIGVGratuitas":1.8000000000000000444089209850062616169452667236328125}},"factura-isc":{"summary":"Factura con ISC","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":41.39999999999999857891452847979962825775146484375,"totalImpuestos":71.400000000000005684341886080801486968994140625,"valorVenta":200.0,"subTotal":271.3999999999999772626324556767940521240234375,"mtoImpVenta":271.3999999999999772626324556767940521240234375,"details":[{"codProducto":"C001","unidad":"NIU","cantidad":2,"descripcion":"CERVEZA 620 ML","mtoValorUnitario":100.0,"mtoBaseIsc":200.0,"porcentajeIsc":15,"isc":30.0,"tipSisIsc":"01","mtoBaseIgv":230.0,"porcentajeIgv":18,"igv":41.39999999999999857891452847979962825775146484375,"tipAfeIgv":"10","totalImpuestos":71.400000000000005684341886080801486968994140625,"mtoValorVenta":200.0,"mtoPrecioUnitario":135.69999999999998863131622783839702606201171875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS SETENTA Y UNO CON 40/100 SOLES"}],"mtoBaseIsc":200.0,"mtoISC":30.0}},"factura-ivap":{"summary":"Factura con IVAP","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"totalImpuestos":8.0,"valorVenta":200.0,"subTotal":208.0,"mtoImpVenta":208.0,"details":[{"codProducto":"A001","unidad":"KGM","cantidad":50,"descripcion":"ARROZ PILADO","mtoValorUnitario":4.0,"mtoBaseIgv":200.0,"porcentajeIgv":4,"igv":8.0,"tipAfeIgv":"17","totalImpuestos":8.0,"mtoValorVenta":200.0,"mtoPrecioUnitario":4.160000000000000142108547152020037174224853515625}],"legends":[{"code":"1000","value":"SON DOSCIENTOS OCHO CON 00/100 SOLES"},{"code":"2007","value":"Operación sujeta al IVAP"}],"mtoBaseIvap":200.0,"mtoIvap":8.0}},"factura-icbper":{"summary":"Factura con ICBPER","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.19999999999998863131622783839702606201171875,"mtoIGV":36.03999999999999914734871708787977695465087890625,"totalImpuestos":37.03999999999999914734871708787977695465087890625,"valorVenta":200.19999999999998863131622783839702606201171875,"subTotal":237.240000000000009094947017729282379150390625,"mtoImpVenta":237.240000000000009094947017729282379150390625,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"BOL01","unidad":"NIU","cantidad":2,"descripcion":"BOLSA DE PLÁSTICO","mtoValorUnitario":0.1000000000000000055511151231257827021181583404541015625,"mtoBaseIgv":0.200000000000000011102230246251565404236316680908203125,"porcentajeIgv":18,"igv":0.040000000000000000832667268468867405317723751068115234375,"tipAfeIgv":"10","icbper":1.0,"factorIcbper":0.5,"totalImpuestos":1.04000000000000003552713678800500929355621337890625,"mtoValorVenta":0.200000000000000011102230246251565404236316680908203125,"mtoPrecioUnitario":0.61999999999999999555910790149937383830547332763671875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SIETE CON 24/100 SOLES"}],"icbper":1.0}},"factura-detraccion":{"summary":"Factura con detracción","value":{"ublVersion":"2.1","tipoOperacion":"1001","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":1000.0,"mtoIGV":180.0,"totalImpuestos":180.0,"valorVenta":1000.0,"subTotal":1180.0,"mtoImpVenta":1180.0,"details":[{"codProducto":"S001","unidad":"ZZ","cantidad":1.0,"descripcion":"SERVICIO DE MANTENIMIENTO","mtoValorUnitario":1000.0,"mtoBaseIgv":1000.0,"porcentajeIgv":18,"igv":180.0,"tipAfeIgv":"10","totalImpuestos":180.0,"mtoValorVenta":1000.0,"mtoPrecioUnitario":1180.0}],"legends":[{"code":"1000","value":"SON MIL CIENTO OCHENTA CON 00/100 SOLES"},{"code":"2006","value":"Operación sujeta a detracción"}],"detraccion":{"codBienDetraccion":"022","codMedioPago":"001","ctaBanco":"00-000-000000","percent":12,"mount":141.599999999999994315658113919198513031005859375}}}}}}},"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/pdf":{"post":{"tags":["Facturas y boletas"],"summary":"Vista previa en PDF","operationId":"postInvoicesPdf","description":"Permiso del token: `invoices`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Invoice"},"examples":{"factura":{"summary":"Factura","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"boleta":{"summary":"Boleta de venta","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"03","serie":"B001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipoMoneda":"PEN","client":{"tipoDoc":"1","numDoc":"12345678","rznSocial":"JUAN PEREZ GARCIA"},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}]}},"factura-credito":{"summary":"Factura al crédito","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Credito","monto":236.0,"moneda":"PEN"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"}],"cuotas":[{"moneda":"PEN","monto":118.0,"fechaPago":"2026-11-08T00:00:00-05:00"},{"moneda":"PEN","monto":118.0,"fechaPago":"2026-12-08T00:00:00-05:00"}]}},"factura-exonerada":{"summary":"Factura exonerada","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoIGV":0,"totalImpuestos":0,"valorVenta":100.0,"subTotal":100.0,"mtoImpVenta":100.0,"details":[{"codProducto":"L001","unidad":"NIU","cantidad":2,"descripcion":"LIBRO DE MATEMÁTICAS","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":0,"igv":0,"tipAfeIgv":"20","totalImpuestos":0,"mtoValorVenta":100.0,"mtoPrecioUnitario":50.0}],"legends":[{"code":"1000","value":"SON CIEN CON 00/100 SOLES"}],"mtoOperExoneradas":100.0}},"factura-gratuita":{"summary":"Factura con bonificación","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":36.0,"totalImpuestos":36.0,"valorVenta":200.0,"subTotal":236.0,"mtoImpVenta":236.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"P003","unidad":"NIU","cantidad":1,"descripcion":"PRODUCTO DE REGALO","mtoValorUnitario":0,"mtoValorGratuito":10.0,"mtoBaseIgv":10.0,"porcentajeIgv":18,"igv":1.8000000000000000444089209850062616169452667236328125,"tipAfeIgv":"15","totalImpuestos":1.8000000000000000444089209850062616169452667236328125,"mtoValorVenta":10.0,"mtoPrecioUnitario":0}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SEIS CON 00/100 SOLES"},{"code":"1002","value":"TRANSFERENCIA GRATUITA DE UN BIEN Y/O SERVICIO PRESTADO GRATUITAMENTE"}],"mtoOperGratuitas":10.0,"mtoIGVGratuitas":1.8000000000000000444089209850062616169452667236328125}},"factura-isc":{"summary":"Factura con ISC","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.0,"mtoIGV":41.39999999999999857891452847979962825775146484375,"totalImpuestos":71.400000000000005684341886080801486968994140625,"valorVenta":200.0,"subTotal":271.3999999999999772626324556767940521240234375,"mtoImpVenta":271.3999999999999772626324556767940521240234375,"details":[{"codProducto":"C001","unidad":"NIU","cantidad":2,"descripcion":"CERVEZA 620 ML","mtoValorUnitario":100.0,"mtoBaseIsc":200.0,"porcentajeIsc":15,"isc":30.0,"tipSisIsc":"01","mtoBaseIgv":230.0,"porcentajeIgv":18,"igv":41.39999999999999857891452847979962825775146484375,"tipAfeIgv":"10","totalImpuestos":71.400000000000005684341886080801486968994140625,"mtoValorVenta":200.0,"mtoPrecioUnitario":135.69999999999998863131622783839702606201171875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS SETENTA Y UNO CON 40/100 SOLES"}],"mtoBaseIsc":200.0,"mtoISC":30.0}},"factura-ivap":{"summary":"Factura con IVAP","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"totalImpuestos":8.0,"valorVenta":200.0,"subTotal":208.0,"mtoImpVenta":208.0,"details":[{"codProducto":"A001","unidad":"KGM","cantidad":50,"descripcion":"ARROZ PILADO","mtoValorUnitario":4.0,"mtoBaseIgv":200.0,"porcentajeIgv":4,"igv":8.0,"tipAfeIgv":"17","totalImpuestos":8.0,"mtoValorVenta":200.0,"mtoPrecioUnitario":4.160000000000000142108547152020037174224853515625}],"legends":[{"code":"1000","value":"SON DOSCIENTOS OCHO CON 00/100 SOLES"},{"code":"2007","value":"Operación sujeta al IVAP"}],"mtoBaseIvap":200.0,"mtoIvap":8.0}},"factura-icbper":{"summary":"Factura con ICBPER","value":{"ublVersion":"2.1","tipoOperacion":"0101","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":200.19999999999998863131622783839702606201171875,"mtoIGV":36.03999999999999914734871708787977695465087890625,"totalImpuestos":37.03999999999999914734871708787977695465087890625,"valorVenta":200.19999999999998863131622783839702606201171875,"subTotal":237.240000000000009094947017729282379150390625,"mtoImpVenta":237.240000000000009094947017729282379150390625,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0},{"codProducto":"P002","unidad":"NIU","cantidad":4.0,"descripcion":"PRODUCTO 2","mtoValorUnitario":25.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":29.5},{"codProducto":"BOL01","unidad":"NIU","cantidad":2,"descripcion":"BOLSA DE PLÁSTICO","mtoValorUnitario":0.1000000000000000055511151231257827021181583404541015625,"mtoBaseIgv":0.200000000000000011102230246251565404236316680908203125,"porcentajeIgv":18,"igv":0.040000000000000000832667268468867405317723751068115234375,"tipAfeIgv":"10","icbper":1.0,"factorIcbper":0.5,"totalImpuestos":1.04000000000000003552713678800500929355621337890625,"mtoValorVenta":0.200000000000000011102230246251565404236316680908203125,"mtoPrecioUnitario":0.61999999999999999555910790149937383830547332763671875}],"legends":[{"code":"1000","value":"SON DOSCIENTOS TREINTA Y SIETE CON 24/100 SOLES"}],"icbper":1.0}},"factura-detraccion":{"summary":"Factura con detracción","value":{"ublVersion":"2.1","tipoOperacion":"1001","tipoDoc":"01","serie":"F001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","formaPago":{"tipo":"Contado"},"tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":1000.0,"mtoIGV":180.0,"totalImpuestos":180.0,"valorVenta":1000.0,"subTotal":1180.0,"mtoImpVenta":1180.0,"details":[{"codProducto":"S001","unidad":"ZZ","cantidad":1.0,"descripcion":"SERVICIO DE MANTENIMIENTO","mtoValorUnitario":1000.0,"mtoBaseIgv":1000.0,"porcentajeIgv":18,"igv":180.0,"tipAfeIgv":"10","totalImpuestos":180.0,"mtoValorVenta":1000.0,"mtoPrecioUnitario":1180.0}],"legends":[{"code":"1000","value":"SON MIL CIENTO OCHENTA CON 00/100 SOLES"},{"code":"2006","value":"Operación sujeta a detracción"}],"detraccion":{"codBienDetraccion":"022","codMedioPago":"001","ctaBanco":"00-000-000000","percent":12,"mount":141.599999999999994315658113919198513031005859375}}}}}}},"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/notes/send":{"post":{"tags":["Notas"],"summary":"Emitir nota de crédito o débito","operationId":"postNotesSend","description":"Permiso del token: `notes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"},"examples":{"nota-credito":{"summary":"Nota de crédito","value":{"ublVersion":"2.1","tipoDoc":"07","serie":"FC01","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipDocAfectado":"01","numDocfectado":"F001-1","codMotivo":"07","desMotivo":"DEVOLUCIÓN POR ÍTEM","tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":100.0,"mtoIGV":18.0,"totalImpuestos":18.0,"valorVenta":100.0,"subTotal":118.0,"mtoImpVenta":118.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0}],"legends":[{"code":"1000","value":"SON CIENTO DIECIOCHO CON 00/100 SOLES"}]}},"nota-debito":{"summary":"Nota de débito","value":{"ublVersion":"2.1","tipoDoc":"08","serie":"FD01","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipDocAfectado":"01","numDocfectado":"F001-1","codMotivo":"01","desMotivo":"INTERESES POR MORA","tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":20.0,"mtoIGV":3.600000000000000088817841970012523233890533447265625,"totalImpuestos":3.600000000000000088817841970012523233890533447265625,"valorVenta":20.0,"subTotal":23.60000000000000142108547152020037174224853515625,"mtoImpVenta":23.60000000000000142108547152020037174224853515625,"details":[{"codProducto":"INT","unidad":"ZZ","cantidad":1.0,"descripcion":"INTERESES POR MORA","mtoValorUnitario":20.0,"mtoBaseIgv":20.0,"porcentajeIgv":18,"igv":3.600000000000000088817841970012523233890533447265625,"tipAfeIgv":"10","totalImpuestos":3.600000000000000088817841970012523233890533447265625,"mtoValorVenta":20.0,"mtoPrecioUnitario":23.60000000000000142108547152020037174224853515625}],"legends":[{"code":"1000","value":"SON VEINTITRÉS CON 60/100 SOLES"}]}}}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/notes/xml":{"post":{"tags":["Notas"],"summary":"XML firmado de la nota sin enviar","operationId":"postNotesXml","description":"Permiso del token: `notes`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Note"},"examples":{"nota-credito":{"summary":"Nota de crédito","value":{"ublVersion":"2.1","tipoDoc":"07","serie":"FC01","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipDocAfectado":"01","numDocfectado":"F001-1","codMotivo":"07","desMotivo":"DEVOLUCIÓN POR ÍTEM","tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":100.0,"mtoIGV":18.0,"totalImpuestos":18.0,"valorVenta":100.0,"subTotal":118.0,"mtoImpVenta":118.0,"details":[{"codProducto":"P001","unidad":"NIU","cantidad":2.0,"descripcion":"PRODUCTO 1","mtoValorUnitario":50.0,"mtoBaseIgv":100.0,"porcentajeIgv":18,"igv":18.0,"tipAfeIgv":"10","totalImpuestos":18.0,"mtoValorVenta":100.0,"mtoPrecioUnitario":59.0}],"legends":[{"code":"1000","value":"SON CIENTO DIECIOCHO CON 00/100 SOLES"}]}},"nota-debito":{"summary":"Nota de débito","value":{"ublVersion":"2.1","tipoDoc":"08","serie":"FD01","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","tipDocAfectado":"01","numDocfectado":"F001-1","codMotivo":"01","desMotivo":"INTERESES POR MORA","tipoMoneda":"PEN","client":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C.","address":{"direccion":"AV. LOS OLIVOS 123, LIMA"}},"mtoOperGravadas":20.0,"mtoIGV":3.600000000000000088817841970012523233890533447265625,"totalImpuestos":3.600000000000000088817841970012523233890533447265625,"valorVenta":20.0,"subTotal":23.60000000000000142108547152020037174224853515625,"mtoImpVenta":23.60000000000000142108547152020037174224853515625,"details":[{"codProducto":"INT","unidad":"ZZ","cantidad":1.0,"descripcion":"INTERESES POR MORA","mtoValorUnitario":20.0,"mtoBaseIgv":20.0,"porcentajeIgv":18,"igv":3.600000000000000088817841970012523233890533447265625,"tipAfeIgv":"10","totalImpuestos":3.600000000000000088817841970012523233890533447265625,"mtoValorVenta":20.0,"mtoPrecioUnitario":23.60000000000000142108547152020037174224853515625}],"legends":[{"code":"1000","value":"SON VEINTITRÉS CON 60/100 SOLES"}]}}}}}},"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/void":{"post":{"tags":["Anulaciones"],"summary":"Anular comprobante (baja o resumen diario)","operationId":"postInvoicesInvoiceVoid","description":"Permiso del token: `invoices, notes`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"motivo":"ERROR EN EL RUC DEL CLIENTE"}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/summaries":{"get":{"tags":["Anulaciones"],"summary":"Listar bajas y resúmenes","operationId":"getSummaries","description":"Permiso del token: `documents`.","parameters":[{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/summaries/{summary}":{"get":{"tags":["Anulaciones"],"summary":"Ver una baja o resumen","operationId":"getSummariesSummary","description":"Permiso del token: `documents`.","parameters":[{"name":"summary","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/summaries/{summary}/status":{"post":{"tags":["Anulaciones"],"summary":"Consultar el ticket de una baja o resumen","operationId":"postSummariesSummaryStatus","description":"Permiso del token: `invoices, notes`.","parameters":[{"name":"summary","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/send":{"post":{"tags":["Guías de remisión"],"summary":"Emitir guía de remisión remitente (09) o transportista (31)","operationId":"postDespatchesSend","description":"Permiso del token: `despatches`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Despatch"},"examples":{"guia-privado":{"summary":"Transporte privado","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"02","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"vehiculo":{"placa":"ABC123"},"choferes":[{"tipo":"Principal","tipoDoc":"1","nroDoc":"44556677","nombres":"JUAN","apellidos":"PÉREZ","licencia":"Q44556677"}]},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-m1l":{"summary":"Vehículo M1 o L","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"02","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"indicadores":["SUNAT_Envio_IndicadorTrasladoVehiculoM1L"]},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-publico":{"summary":"Transporte público","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"01","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"transportista":{"tipoDoc":"6","numDoc":"20000000002","rznSocial":"TRANSPORTES S.A.C.","nroMtc":"0001"}},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-transportista":{"summary":"Guía transportista (31)","value":{"tipoDoc":"31","serie":"V001","fechaEmision":"2026-10-08T10:30:00-05:00","remitente":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"relDocs":[{"tipo":"09","nro":"T001-123","emisor":"20100070970"}],"envio":{"fecTraslado":"2026-10-08","pesoTotal":1500,"undPesoTotal":"KGM","indicadores":["SUNAT_Envio_IndicadorPagadorFlete_Remitente"],"partida":{"ubigueo":"150101","direccion":"AV. ARGENTINA 123"},"llegada":{"ubigueo":"040101","direccion":"AV. EJÉRCITO 456"},"vehiculo":{"placa":"ABC123","nroCirculacion":"15M21028326E","secundarios":[{"placa":"XYZ789"}]},"choferes":[{"tipo":"Principal","tipoDoc":"1","nroDoc":"44556677","nombres":"JUAN","apellidos":"PÉREZ","licencia":"Q44556677"}]},"details":[{"codigo":"P001","descripcion":"BOLSAS DE CEMENTO 42.5 KG","unidad":"NIU","cantidad":50}]}}}}}},"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/xml":{"post":{"tags":["Guías de remisión"],"summary":"XML firmado de la guía sin enviar","operationId":"postDespatchesXml","description":"Permiso del token: `despatches`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Despatch"},"examples":{"guia-privado":{"summary":"Transporte privado","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"02","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"vehiculo":{"placa":"ABC123"},"choferes":[{"tipo":"Principal","tipoDoc":"1","nroDoc":"44556677","nombres":"JUAN","apellidos":"PÉREZ","licencia":"Q44556677"}]},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-m1l":{"summary":"Vehículo M1 o L","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"02","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"indicadores":["SUNAT_Envio_IndicadorTrasladoVehiculoM1L"]},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-publico":{"summary":"Transporte público","value":{"version":"2022","tipoDoc":"09","serie":"T001","correlativo":"1","fechaEmision":"2026-10-08T10:30:00-05:00","destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"envio":{"codTraslado":"01","desTraslado":"VENTA","modTraslado":"01","fecTraslado":"2026-10-08T10:30:00-05:00","pesoTotal":12.5,"undPesoTotal":"KGM","numBultos":2,"partida":{"ubigueo":"150101","direccion":"AV. LIMA 123"},"llegada":{"ubigueo":"150122","direccion":"AV. LARCO 456"},"transportista":{"tipoDoc":"6","numDoc":"20000000002","rznSocial":"TRANSPORTES S.A.C.","nroMtc":"0001"}},"details":[{"codigo":"P001","descripcion":"PRODUCTO 1","unidad":"NIU","cantidad":2},{"codigo":"P002","descripcion":"PRODUCTO 2","unidad":"KGM","cantidad":10.5}]}},"guia-transportista":{"summary":"Guía transportista (31)","value":{"tipoDoc":"31","serie":"V001","fechaEmision":"2026-10-08T10:30:00-05:00","remitente":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"destinatario":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"EMPRESA CLIENTE S.A.C."},"relDocs":[{"tipo":"09","nro":"T001-123","emisor":"20100070970"}],"envio":{"fecTraslado":"2026-10-08","pesoTotal":1500,"undPesoTotal":"KGM","indicadores":["SUNAT_Envio_IndicadorPagadorFlete_Remitente"],"partida":{"ubigueo":"150101","direccion":"AV. ARGENTINA 123"},"llegada":{"ubigueo":"040101","direccion":"AV. EJÉRCITO 456"},"vehiculo":{"placa":"ABC123","nroCirculacion":"15M21028326E","secundarios":[{"placa":"XYZ789"}]},"choferes":[{"tipo":"Principal","tipoDoc":"1","nroDoc":"44556677","nombres":"JUAN","apellidos":"PÉREZ","licencia":"Q44556677"}]},"details":[{"codigo":"P001","descripcion":"BOLSAS DE CEMENTO 42.5 KG","unidad":"NIU","cantidad":50}]}}}}}},"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}/status":{"post":{"tags":["Guías de remisión"],"summary":"Consultar el ticket de una guía","operationId":"postDespatchesDespatchStatus","description":"Permiso del token: `despatches`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions":{"get":{"tags":["Retenciones"],"summary":"Listar comprobantes de retención","operationId":"getRetentions","description":"Permiso del token: `withholdings`.","parameters":[{"name":"ruc","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/send":{"post":{"tags":["Retenciones"],"summary":"Emitir comprobante de retención","operationId":"postRetentionsSend","description":"Permiso del token: `withholdings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"serie":"R001","regimen":"01","proveedor":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"details":[{"tipoDoc":"01","numDoc":"F001-4521","fechaEmision":"2026-10-01","moneda":"PEN","impTotal":1180}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/xml":{"post":{"tags":["Retenciones"],"summary":"XML firmado del comprobante de retención sin enviar","operationId":"postRetentionsXml","description":"Permiso del token: `withholdings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"serie":"R001","regimen":"01","proveedor":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"details":[{"tipoDoc":"01","numDoc":"F001-4521","fechaEmision":"2026-10-01","moneda":"PEN","impTotal":1180}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/{withholding}":{"get":{"tags":["Retenciones"],"summary":"Ver comprobante de retención","operationId":"getRetentionsWithholding","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/{withholding}/pdf":{"get":{"tags":["Retenciones"],"summary":"PDF del comprobante de retención","operationId":"getRetentionsWithholdingPdf","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/{withholding}/xml":{"get":{"tags":["Retenciones"],"summary":"XML del comprobante de retención","operationId":"getRetentionsWithholdingXml","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/retentions/{withholding}/cdr":{"get":{"tags":["Retenciones"],"summary":"CDR del comprobante de retención","operationId":"getRetentionsWithholdingCdr","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions":{"get":{"tags":["Percepciones"],"summary":"Listar comprobantes de percepción","operationId":"getPerceptions","description":"Permiso del token: `withholdings`.","parameters":[{"name":"ruc","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/send":{"post":{"tags":["Percepciones"],"summary":"Emitir comprobante de percepción","operationId":"postPerceptionsSend","description":"Permiso del token: `withholdings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"serie":"P001","regimen":"01","cliente":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"details":[{"tipoDoc":"01","numDoc":"F001-25","fechaEmision":"2026-10-01","moneda":"PEN","impTotal":1180}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/xml":{"post":{"tags":["Percepciones"],"summary":"XML firmado del comprobante de percepción sin enviar","operationId":"postPerceptionsXml","description":"Permiso del token: `withholdings`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"serie":"P001","regimen":"01","cliente":{"tipoDoc":"6","numDoc":"20100070970","rznSocial":"SUPERMERCADOS PERUANOS SOCIEDAD ANONIMA"},"details":[{"tipoDoc":"01","numDoc":"F001-25","fechaEmision":"2026-10-01","moneda":"PEN","impTotal":1180}]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/{withholding}":{"get":{"tags":["Percepciones"],"summary":"Ver comprobante de percepción","operationId":"getPerceptionsWithholding","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/{withholding}/pdf":{"get":{"tags":["Percepciones"],"summary":"PDF del comprobante de percepción","operationId":"getPerceptionsWithholdingPdf","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/{withholding}/xml":{"get":{"tags":["Percepciones"],"summary":"XML del comprobante de percepción","operationId":"getPerceptionsWithholdingXml","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/perceptions/{withholding}/cdr":{"get":{"tags":["Percepciones"],"summary":"CDR del comprobante de percepción","operationId":"getPerceptionsWithholdingCdr","description":"Permiso del token: `withholdings`.","parameters":[{"name":"withholding","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/receivables":{"get":{"tags":["Cobranzas"],"summary":"Cuentas por cobrar con antigüedad de la deuda","operationId":"getReceivables","description":"Permiso del token: `payments`.","parameters":[{"name":"cliente","in":"query","required":false,"schema":{"type":"string"}},{"name":"estado","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/payments":{"get":{"tags":["Cobranzas"],"summary":"Pagos y saldo de un comprobante","operationId":"getInvoicesInvoicePayments","description":"Permiso del token: `payments`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Cobranzas"],"summary":"Registrar un pago","operationId":"postInvoicesInvoicePayments","description":"Permiso del token: `payments`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"fecha":"2026-10-15","monto":50,"metodo":"yape","referencia":"OP 123456"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/payments/{payment}":{"delete":{"tags":["Cobranzas"],"summary":"Eliminar un pago","operationId":"deleteInvoicesInvoicePaymentsPayment","description":"Permiso del token: `payments`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}},{"name":"payment","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices":{"get":{"tags":["Comprobantes"],"summary":"Listar y filtrar comprobantes","operationId":"getInvoices","description":"Permiso del token: `documents`.","parameters":[{"name":"tipoDoc","in":"query","required":false,"schema":{"type":"string"}},{"name":"serie","in":"query","required":false,"schema":{"type":"string"}},{"name":"correlativo","in":"query","required":false,"schema":{"type":"string"}},{"name":"cliente","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"sistema","in":"query","required":false,"schema":{"type":"string"}},{"name":"mios","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/reference/{externalId}":{"get":{"tags":["Comprobantes"],"summary":"Buscar por referencia externa","operationId":"getInvoicesReferenceExternalId","description":"Permiso del token: `documents`.","parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}":{"get":{"tags":["Comprobantes"],"summary":"Ver un comprobante","operationId":"getInvoicesInvoice","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/consult":{"post":{"tags":["Comprobantes"],"summary":"Consultar estado y CDR en SUNAT (producción)","operationId":"postInvoicesInvoiceConsult","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Resultado (revisa success y estado)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentResponse"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/email":{"post":{"tags":["Comprobantes"],"summary":"Enviar por correo","operationId":"postInvoicesInvoiceEmail","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"cliente@correo.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/pdf":{"get":{"tags":["Comprobantes"],"summary":"Descargar PDF (format: a4, a5, ticket-80, ticket-58)","operationId":"getInvoicesInvoicePdf","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/xml":{"get":{"tags":["Comprobantes"],"summary":"Descargar XML","operationId":"getInvoicesInvoiceXml","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/invoices/{invoice}/cdr":{"get":{"tags":["Comprobantes"],"summary":"Descargar CDR","operationId":"getInvoicesInvoiceCdr","description":"Permiso del token: `documents`.","parameters":[{"name":"invoice","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/documents/export":{"get":{"tags":["Comprobantes"],"summary":"Descargar en ZIP los XML, CDR y PDF de un periodo","operationId":"getDocumentsExport","description":"Permiso del token: `documents`.","parameters":[{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"tipos","in":"query","required":false,"schema":{"type":"string"}},{"name":"archivos","in":"query","required":false,"schema":{"type":"string"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches":{"get":{"tags":["Guías de remisión"],"summary":"Listar guías","operationId":"getDespatches","description":"Permiso del token: `documents`.","parameters":[{"name":"tipoDoc","in":"query","required":false,"schema":{"type":"string"}},{"name":"serie","in":"query","required":false,"schema":{"type":"string"}},{"name":"correlativo","in":"query","required":false,"schema":{"type":"string"}},{"name":"cliente","in":"query","required":false,"schema":{"type":"string"}},{"name":"desde","in":"query","required":false,"schema":{"type":"string"}},{"name":"hasta","in":"query","required":false,"schema":{"type":"string"}},{"name":"externalId","in":"query","required":false,"schema":{"type":"string"}},{"name":"sistema","in":"query","required":false,"schema":{"type":"string"}},{"name":"mios","in":"query","required":false,"schema":{"type":"string"}},{"name":"per_page","in":"query","required":false,"schema":{"type":"string"}},{"name":"page","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/reference/{externalId}":{"get":{"tags":["Guías de remisión"],"summary":"Buscar guía por referencia externa","operationId":"getDespatchesReferenceExternalId","description":"Permiso del token: `documents`.","parameters":[{"name":"externalId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}":{"get":{"tags":["Guías de remisión"],"summary":"Ver una guía","operationId":"getDespatchesDespatch","description":"Permiso del token: `documents`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}/email":{"post":{"tags":["Guías de remisión"],"summary":"Enviar guía por correo","operationId":"postDespatchesDespatchEmail","description":"Permiso del token: `documents`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"},"example":{"email":"cliente@correo.com"}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Datos inválidos (detalle en errors)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}/pdf":{"get":{"tags":["Guías de remisión"],"summary":"Descargar PDF de la guía (format: a4, a5)","operationId":"getDespatchesDespatchPdf","description":"Permiso del token: `documents`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}},{"name":"format","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Archivo","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}/xml":{"get":{"tags":["Guías de remisión"],"summary":"Descargar XML de la guía","operationId":"getDespatchesDespatchXml","description":"Permiso del token: `documents`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/xml":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/despatches/{despatch}/cdr":{"get":{"tags":["Guías de remisión"],"summary":"Descargar CDR de la guía","operationId":"getDespatchesDespatchCdr","description":"Permiso del token: `documents`.","parameters":[{"name":"despatch","in":"path","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Archivo","content":{"application/zip":{"schema":{"type":"string","format":"binary"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Token ausente o inválido","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"El plan no lo permite (ver code)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"El token no tiene permiso o la cuenta está suspendida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"No existe o pertenece a otra empresa","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Superaste las peticiones por minuto de tu plan (code: rate_limited, cabecera Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"token":{"type":"http","scheme":"bearer","description":"Token de la empresa. Se crea en el panel, en \"Sistemas y tokens API\"."}},"headers":{"X-RateLimit-Limit":{"description":"Peticiones por minuto que permite tu plan.","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Peticiones que te quedan en este minuto.","schema":{"type":"integer"}}},"schemas":{"Error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string","description":"no_subscription, subscription_expired, documents_limit, feature_not_included, account_suspended, rate_limited, not_registered…"},"errors":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string"}}}}},"DocumentResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"true si quedó aceptado u observado."},"estado":{"type":"string","enum":["aceptado","observado","rechazado","pendiente","error","anulado"]},"duplicado":{"type":"boolean","description":"true si ya existía un comprobante con el mismo externalId."},"document":{"$ref":"#/components/schemas/Document"},"hash":{"type":"string"},"xml":{"type":"string"},"sunatResponse":{"type":"object","properties":{"success":{"type":"boolean"},"cdrZip":{"type":"string","nullable":true,"description":"CDR en base64."},"cdrResponse":{"type":"object","nullable":true},"error":{"type":"object","nullable":true},"ticket":{"type":"string","nullable":true}}}}},"Document":{"type":"object","properties":{"id":{"type":"integer"},"externalId":{"type":"string","nullable":true},"sistema":{"type":"string"},"tipoDoc":{"type":"string"},"serie":{"type":"string"},"correlativo":{"type":"integer"},"numero":{"type":"string","example":"F001-00000006"},"links":{"type":"object","properties":{"pdf":{"type":"string"},"xml":{"type":"string"},"cdr":{"type":"string"}}},"plazoEnvio":{"type":"string","format":"date","nullable":true},"anulacion":{"type":"object","nullable":true}}},"Invoice":{"type":"object","description":"Campos de Greenter. Ver la documentación para el detalle de cada campo.","required":["ublVersion","tipoOperacion","tipoDoc","serie","fechaEmision","tipoMoneda","client","details"]},"Note":{"type":"object","description":"Nota de crédito (07) o débito (08) con los campos de Greenter.","required":["tipoDoc","serie","tipDocAfectado","numDocfectado","codMotivo","desMotivo","client","details"]},"Despatch":{"type":"object","description":"Guía de remisión remitente (09, campos de Greenter) o transportista (31: tipoDoc, remitente, destinatario, relDocs, envio.vehiculo, envio.choferes).","required":["serie","fechaEmision","destinatario","envio","details"]}}}}