---
name: faktura-descargar-el-cdr
description: "Descargar el CDR con la API de Faktura (facturación electrónica SUNAT, Perú). Devuelve la constancia de recepción de SUNAT tal como la entregó (Content-Type: application/zip, p. ej. R-20000000001-03-B001-1.zip). Conserva este archivo:… Úsala cuando integres esta operación desde tu sistema."
---

# Skill: Descargar el CDR — Faktura API

## Propósito

Le da a tu asistente el contexto para **descargar el CDR** con la API de Faktura: Devuelve la constancia de recepción de SUNAT tal como la entregó (Content-Type: application/zip, p. ej. R-20000000001-03-B001-1.zip). Conserva este archivo:…

Instalación en Claude Code: guarda este archivo como `.claude/skills/faktura-descargar-el-cdr/SKILL.md` en tu proyecto. Fuente: https://faktura-doc.cgallardo.me/endpoints/comprobantes/cdr/

## Endpoint

| Ambiente | Petición |
| --- | --- |
| Pruebas | `GET https://faktura-test.cgallardo.me/v1/documents/{id}/cdr` |
| Producción | `GET https://faktura.cgallardo.me/v1/documents/{id}/cdr` |

## Autenticación y cabeceras

- `Authorization: Bearer <api key>`. En pruebas, una clave `sk_test_` (SUNAT beta, sin valor tributario); en producción, la `sk_live_`. El ambiente lo decide la clave.
- `Content-Type: application/json` en las peticiones con cuerpo.
- `Idempotency-Key` (recomendada al emitir): repetir la petición con la misma clave y el mismo cuerpo devuelve el mismo comprobante, sin duplicarlo.
- Errores: JSON `{ "reason": "<código>", "details": [...] }`. `401` clave inválida o vencida, `403` alcance insuficiente, `422` datos inválidos, `429` límite de 120 peticiones por minuto (respeta `Retry-After`), `500` solo con `traceId`.

## Ejemplo

```bash
curl -OJ https://faktura-test.cgallardo.me/v1/documents/<id>/cdr -H "Authorization: Bearer sk_test_..."
```

## Respuestas y errores

| Estado | `reason` | Significado |
| --- | --- | --- |
| `200` | — | Devuelve el archivo ZIP del CDR (`application/zip`). |
| `401` | `Unauthenticated` | Falta la API key, es inválida o venció. |
| `403` | `ApiKeyScopeInsufficient` | La clave es de alcance `lookup`. |
| `404` | `NotFound` | El comprobante no existe para tu clave o SUNAT aún no entregó el CDR (`links.cdr` es `null`). |
| `429` | `TooManyRequests` | Superaste las 120 peticiones por minuto. |

## Reglas generales de la API

- Montos en las respuestas como texto decimal (`"16.00"`); en las peticiones, número o texto.
- Fechas `YYYY-MM-DD` en hora de Perú (`America/Lima`); identificadores UUID.
- Un comprobante emitido responde `201` con `status: "pending"`: el número ya es tuyo. El resultado de SUNAT llega después (webhook o `GET /v1/documents/{id}`).
- Documentación completa: https://faktura-doc.cgallardo.me/ · Toda la API en una skill: https://faktura-doc.cgallardo.me/skills/faktura-api.md
