Comprobante de Retención (20)

Régimen de Retenciones del IGV — tasa vigente 3%.

POST/v1/retentions

El Comprobante de Retención (Tipo 20) acredita que tu empresa, como agente de retención, retuvo el IGV de un pago a un proveedor. Solo puede referenciar Facturas (01) — no boletas ni otros comprobantes.

Reglas Principales

Serie: Debe iniciar con la letra R (ej. R001).
Moneda: Siempre PEN (el régimen de retenciones es exclusivamente en soles).
Documentos referenciados: documents[].doc_type debe ser "01" (Factura) — cualquier otro valor es rechazado.
Tasa: retention_rate por defecto 0.03 (3%, tasa vigente del régimen desde 2014). El retention_amount de cada documento debe ser exactamente (payment_amount + retention_amount) × retention_rate.
Totales: total_retention y total_paid deben coincidir exactamente con la suma de retention_amount/payment_amount de todos los documentos — no se tolera redondeo.

curl -X POST https://api.yoemito.dev/v1/retentions \ -H "Authorization: Bearer ye_test_..." \ -H "Idempotency-Key: ret_unique_888" \ -H "Content-Type: application/json" \ -d '{ "issuer_id": "iss_7cef8c05aa4a4e2a9b1cfa1e8c3d1234", "retention": { "series": "R001", "issue_date": "2026-09-17", "currency": "PEN", "recipient": { "doc_type": "6", "doc_number": "20513469129", "name": "PROVEEDOR S.A.C." }, "retention_rate": "0.03", "total_retention": "30.00", "total_paid": "970.00", "documents": [ { "doc_type": "01", "series": "F001", "number": 128, "issue_date": "2026-09-11", "total_amount": "1000.00", "payment_amount": "970.00", "retention_amount": "30.00", "retention_date": "2026-09-17" } ] } }'

{ "id": "doc_05m0zbjszb1tkmnjf509trm8p0", "type": "retention", "status": "queued", "issuer_ruc": "20513469129", "series": "R001", "number": 1, "totals": { "total": "30.00", "currency": "PEN" }, "links": { "self": "/v1/retentions/doc_05m0zbjszb1tkmnjf509trm8p0", "xml": "/v1/documents/doc_05m0zbjszb1tkmnjf509trm8p0/xml", "pdf": "/v1/documents/doc_05m0zbjszb1tkmnjf509trm8p0/pdf" } }