Introducción
Entornos
Sección titulada «Entornos»B2Brouter tiene tres entornos — consulta Entornos para una comparativa completa.
| Entorno | URL base | Cuándo usar |
|---|---|---|
| Sandbox | https://api.b2brouter.net (prefijo de clave test_) | Desarrollo diario, validación de payloads, onboarding |
| Staging | https://api-staging.b2brouter.net | Integraciones grandes, pruebas end-to-end amplias, entornos QA de autoridades |
| Production | https://api.b2brouter.net | Tráfico en producción |
Empieza con Sandbox. Es el entorno recomendado para el desarrollo inicial y las pruebas diarias. Usa staging solo para integraciones a gran escala o pruebas end-to-end amplias que requieran una configuración completa del entorno.
Primeros pasos
Sección titulada «Primeros pasos»Regístrate y configura tu cuenta
Sección titulada «Regístrate y configura tu cuenta»Para empezar a usar la API de B2Brouter, regístrate en app.b2brouter.net/es/register. Las instrucciones de configuración detalladas están disponibles aquí.
Una vez registrado, inicia sesión en B2Brouter y configura tu cuenta con un plan Basic. Puedes encontrar instrucciones detalladas aquí.
Obtén una clave API de sandbox
Sección titulada «Obtén una clave API de sandbox»Abre la sección Developers y crea un sandbox. Tu clave API de sandbox empieza con test_ y redirige todas las solicitudes al entorno sandbox automáticamente — no se necesita una URL separada. Consulta Sandbox para las instrucciones completas de configuración.
Activación del entorno Staging
Sección titulada «Activación del entorno Staging»Si necesitas el entorno de staging (integraciones grandes, pruebas end-to-end amplias), regístrate en app-staging.b2brouter.net/es/register. Las cuentas de staging comienzan con permisos limitados — envía un ticket de soporte para solicitar el acceso necesario. Nuestro equipo te lo concederá.
Uso de la API REST
Sección titulada «Uso de la API REST»Para acceder a la API de B2Brouter, sigue estos pasos:
- Accede a tu cuenta.
- Dentro de tu cuenta, haz clic en la pestaña Developers.
- Haz clic en la clave API para copiarla al portapapeles.
- Para encontrar los IDs de las cuentas, haz clic en Ver IDs de cada cuenta o en el icono Editar grupo junto al nombre de tu grupo.
- Accede a la Referencia de la API.
Nota:
Las claves API son específicas de cada entorno. Las claves de sandbox (prefijo test_) solo funcionan en sandbox; las de producción solo funcionan en producción; las de staging solo funcionan en staging. Obtén cada clave iniciando sesión en el entorno correspondiente.
Por defecto, la Referencia de la API está documentada con el entorno de staging. Para cambiar a sandbox o producción, abre el desplegable Base URL.
Autenticación
Sección titulada «Autenticación»Las credenciales deben proporcionarse en las cabeceras de la solicitud, con el nombre X-B2B-API-Key.
Versión de la API
Sección titulada «Versión de la API»En B2Brouter, cada grupo tiene una versión de API predeterminada. Puedes consultarla en la pestaña Developers, en API Keys. Puedes especificar manualmente la versión de la API en las cabeceras de la solicitud, con el nombre X-B2B-API-Version. Si no se especifica ninguna versión, B2Brouter utilizará la versión predeterminada del grupo.
Formatos de respuesta
Sección titulada «Formatos de respuesta»B2Brouter solo proporciona la respuesta en formato JSON.
Identificadores de cuenta
Sección titulada «Identificadores de cuenta»Usa el endpoint List Accounts
curl --request GET \ --url https://api-staging.b2brouter.net/accounts \ --header 'X-B2B-API-Key: {YOUR_API_KEY}' \ --header 'X-B2B-API-Version: {YOUR_API_VERSION}' \ --header 'accept: application/json'En esta respuesta, presta atención a la información del campo identifier. Debes usar este ID cuando quieras interactuar con la cuenta a través de la API.
Nota: También puedes encontrar los IDs de las cuentas en la pestaña Developers haciendo clic en el icono Editar grupo junto al nombre de tu grupo. Se mostrará la lista de cuentas y sus IDs.
Límite de solicitudes de la API
Sección titulada «Límite de solicitudes de la API»Para garantizar un rendimiento óptimo y un uso equitativo, la API de B2Brouter aplica límites de solicitudes:
Límites de solicitudes:
- Production: 1.000 solicitudes por minuto
- Sandbox / Staging: 600 solicitudes por minuto
Límite de solicitudes superado: Cuando superas el límite de solicitudes, la API devuelve:
- Código de estado HTTP
429 Too Many Requests
Buenas prácticas:
- Implementa backoff exponencial cuando recibas respuestas 429
- Almacena respuestas en caché cuando sea posible para reducir las llamadas a la API
- Usa webhooks en lugar de polling para actualizaciones en tiempo real
SDKs y librerías de cliente
Sección titulada «SDKs y librerías de cliente»Puedes integrarte con la API directamente a través de HTTP o usando un SDK oficial. El primer SDK oficial es el PHP SDK:
Proporciona métodos para la gestión completa de facturas, descargas de documentos en múltiples formatos, operaciones completas de informes fiscales (incluyendo Verifactu), utilidades de paginación y gestión de errores. Con el tiempo se añadirán SDKs adicionales para otros lenguajes de programación.
Descargar la referencia OpenAPI
Sección titulada «Descargar la referencia OpenAPI»Puedes descargar la referencia completa de la API REST en formato OpenAPI (YAML) desde los siguientes enlaces: