Series
Lista las series activas de tu empresa en el entorno de tu API key, con el siguiente correlativo que se asignará. Las series las crea el equipo de Faktura al dar de alta tu empresa; pide una nueva si abres otra caja o establecimiento.
curl https://faktura-test.cgallardo.me/v1/series -H "Authorization: Bearer sk_test_..."use Illuminate\Support\Facades\Http;
$response = Http::withToken('sk_test_...') ->get('https://faktura-test.cgallardo.me/v1/series');
$data = $response->json();const response = await fetch('https://faktura-test.cgallardo.me/v1/series', { headers: { Authorization: 'Bearer sk_test_...', },});const data = await response.json();Método: GET
Endpoint
Sección titulada «Endpoint»GET https://faktura-test.cgallardo.me/v1/seriesGET https://faktura.cgallardo.me/v1/seriesRespuesta 200 OK
Sección titulada «Respuesta 200 OK»{ "items": [ { "id": "01a1d52b-92d5-701b-9ee2-275218fd6f62", "document_type": "01", "code": "F001", "branch_code": "0000", "next_number": 1 }, { "id": "01a1d52b-936e-707a-ae38-2a5f8d661979", "document_type": "03", "code": "B001", "branch_code": "0000", "next_number": 2 } ]}| Campo | Descripción |
|---|---|
document_type |
01 factura, 03 boleta, 07 nota de crédito, 08 nota de débito. |
code |
Serie que envías en series al emitir (F001, B001, FC01, BC01, FD01, BD01). |
branch_code |
Código del establecimiento anexo ante SUNAT (0000 es el domicilio fiscal). |
next_number |
Correlativo que recibirá la próxima emisión exitosa. Es informativo: con emisiones concurrentes puede avanzar entre la consulta y tu emisión. |
Respuestas y errores
Sección titulada «Respuestas y errores»| Estado | reason |
Significado |
|---|---|---|
200 |
— | Devuelve las series activas del emisor en el entorno de la clave. |
401 |
Unauthenticated |
Falta la API key, es inválida o venció. |
403 |
ApiKeyScopeInsufficient |
La clave es de alcance lookup. |
429 |
TooManyRequests |
Superaste las 120 peticiones por minuto. |