> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.
# Configuración de canales
> Lee la configuración activa de canales de venta (con tipos de fulfillment) para tu vendor. Úsalo para saber qué canales y combinaciones de fulfillment puede usar tu integración.
Devuelve la configuración completa de canales de venta para tu vendor, enriquecida con datos del catálogo global (`uuid`, `name`, `description`) y los tipos de fulfillment configurados para cada canal.
El endpoint no acepta query params. Solo retorna canales con `enabled !== false`. Los canales que no tengan match en el catálogo se excluyen de la respuesta.
## Autenticación
Tu API key de Fire con el scope `channels:read`. La key **debe ser vendor-scoped** (account + vendor binding) — las keys sin `vendorId` son rechazadas con `403`. El account y el vendor se resuelven desde la key, así que no hace falta header `account` ni query param.
## Petición
```http theme={null}
GET https://api.fire.rest/api/v1/fire/external/channels/config
x-api-key:
```
## Respuesta
UUID del account al que pertenece la API key.
ISO 3166-1 alpha-2 (ej. `BR`, `EC`, `CO`).
Identificador del vendor.
Nombre legible del vendor.
UUID del catálogo global de `channels`.
Código del canal (ej. `APP`, `KIOSK`, `WEB`).
Nombre display.
Descripción opcional.
Siempre `true` en las filas devueltas.
UUID del catálogo global de `fulfillment_types`.
Código (ej. `DELIVERY`, `PICKUP`).
Nombre display.
Nombre interno de referencia.
Descripción opcional.
Siempre `true` en las filas devueltas.
```json 200 theme={null}
{
"accountId": "550e8400-e29b-41d4-a716-446655440000",
"countries": [
{
"countryCode": "EC",
"vendors": [
{
"vendorId": "100.1.10",
"vendorName": "Sandbox Ecuador",
"channels": [
{
"uuid": "9f3a-...-e1",
"code": "APP",
"name": "App Móvil",
"description": "Canal de venta por aplicación móvil",
"enabled": true,
"fulfillmentTypes": [
{
"uuid": "abcf-...-2d",
"code": "DELIVERY",
"name": "Delivery",
"referenceName": "DELIVERY",
"description": null,
"enabled": true
}
]
},
{
"uuid": "7e2b-...-c8",
"code": "KIOSK",
"name": "Kiosco",
"description": null,
"enabled": true,
"fulfillmentTypes": []
}
]
}
]
}
]
}
```
```json 401 — API key inválida theme={null}
{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}
```
```json 403 theme={null}
{
"error": {
"code": "forbidden",
"message": "Access denied"
}
}
```
## Notas
* `uuid` viene del catálogo global de `channels`, no del JSONB por account.
* `fulfillmentTypes` solo incluye los tipos configurados para ese canal en el vendor. Tipos sin match en el catálogo se excluyen.
* `countries` agrupa por código de país del JSONB. Un vendor puede aparecer en múltiples países si tiene configuración por país.
## Relacionado
Endpoint companion para leer los métodos de pago configurados.
Cómo funcionan las API keys vendor-scoped y los scopes.