Series de facturación

GET https://api.afer.pro/api/v1/numbering-series

Alias en castellano (v0, sigue operativo): POST https://api.afer.pro/consultarSeries

Las series de numeración de factura de tu cuenta y qué significa cada una.

Cada serie lleva sus banderas: si es de tickets, si es proforma y si es de rectificativas.

La bandera importante para cuadrar cifras es es_proforma: las facturas de una serie proforma quedan fuera de todos los agregados de ventas de la API (consultarVentas, consultarResumen, consultarFacturas…). Si tus números no cuadran con los del panel, empieza por aquí.

Autenticación

Envía tus claves API en las cabeceras X-API-KEY y X-API-SECRET. La cuenta sobre la que se opera se resuelve automáticamente a partir de la clave. Cómo obtener tus claves →

Este endpoint requiere autenticación con API key: sin credenciales responde 401.

Parámetros del cuerpo

Este endpoint no necesita parámetros: basta un cuerpo JSON vacío ({}) con tus cabeceras de autenticación.

Ejemplo de petición

curl -X GET 'https://api.afer.pro/api/v1/numbering-series' \
  -H 'X-API-KEY: afer_tk_TU_TOKEN' \
  -H 'X-API-SECRET: afer_sk_TU_SECRET'

<?php

$ch = curl_init('https://api.afer.pro/api/v1/numbering-series');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'X-API-KEY: afer_tk_TU_TOKEN',
    'X-API-SECRET: afer_sk_TU_SECRET',
]);

$respuesta = json_decode(curl_exec($ch), true);
curl_close($ch);

const respuesta = await fetch('https://api.afer.pro/api/v1/numbering-series', {
  method: 'GET',
  headers: {
    'X-API-KEY': 'afer_tk_TU_TOKEN',
    'X-API-SECRET': 'afer_sk_TU_SECRET'
  }
});

const resultado = await respuesta.json();

Respuesta

200 · application/json

{
    "errorCode": 200,
    "errorMsg": "",
    "data": {
        "total_series": 2,
        "series": [
            {
                "serieId": "sEr1…",
                "serie": "FA",
                "es_serie_tickets": false,
                "es_proforma": false,
                "es_rectificativas": false,
                "enlace_contable": true
            },
            {
                "serieId": "sEr7…",
                "serie": "PRO",
                "es_serie_tickets": false,
                "es_proforma": true,
                "es_rectificativas": false,
                "enlace_contable": false
            }
        ]
    }
}