---
name: faktura-reenviar-un-comprobante-que-fallo
description: "Reenviar un comprobante que falló con la API de Faktura (facturación electrónica SUNAT, Perú). Un comprobante en estado failed no llegó a SUNAT por una causa ajena a su contenido: usuario o clave SOL incorrectos, perfil sin permiso o emisor sin credenc… Úsala cuando integres esta operación desde tu sistema."
---

# Skill: Reenviar un comprobante que falló — Faktura API

## Propósito

Le da a tu asistente el contexto para **reenviar un comprobante que falló** con la API de Faktura: Un comprobante en estado failed no llegó a SUNAT por una causa ajena a su contenido: usuario o clave SOL incorrectos, perfil sin permiso o emisor sin credenc…

Instalación en Claude Code: guarda este archivo como `.claude/skills/faktura-reenviar-un-comprobante-que-fallo/SKILL.md` en tu proyecto. Fuente: https://faktura-doc.cgallardo.me/endpoints/comprobantes/reintentar/

## Endpoint

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

## 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 -X POST https://faktura-test.cgallardo.me/v1/documents/<id>/retry -H "Authorization: Bearer sk_test_..."
```

## Respuesta `202 Accepted`

```json
{
  "id": "01a1d5fc-899b-720e-a6ea-03d37a346f81",
  "status": "pending"
}
```

## Errores

| Estado | `reason` | Causa |
| --- | --- | --- |
| `409` | `DocumentNotRetryable` | El comprobante no está `failed`. Uno `rejected` no se reenvía: su contenido es inválido y corresponde emitir otro. |
| `404` | `NotFound` | El comprobante no existe para tu clave. |

## 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
