> ## Documentation Index
> Fetch the complete documentation index at: https://firespark.cloud/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener opción de fulfillment

> Lee una definición de tipo de fulfillment por id externo.

Devuelve una opción de fulfillment para el comercio autenticado. Usa este endpoint cuando ya conoces el `id` externo y necesitas el nombre, código de tipo y estado actuales sin listar todas las opciones.

> [!NOTE]
>
> Requiere un access token con el scope `fulfillment:read`. Consulta
> [Token](https://firespark.cloud/docs/es/integrations-api/oauth/token/post.md) para obtener un token.

## Parámetros de ruta

| Parámetro | Tipo | Descripción |
| - | - | - |
| `id` | string | Identificador externo de fulfillment. Solo caracteres alfanuméricos, `_` y `-`. 1–64 caracteres. Único por comercio. |

## Parámetros de consulta

| Parámetro | Requerido | Descripción |
| - | - | - |
| `channel_id` | No | Identificador externo del canal. Si se indica, responde 404 salvo que `channel_ids` del fulfillment lo incluya. |

## Solicitud

Reemplaza `{id}` con el identificador externo de fulfillment.

```bash theme={null}
curl "https://firespark.cloud/api/integrations/v1/fulfillment/delivery?channel_id=app" \
  -H "Authorization: Bearer ACCESS_TOKEN"
```

## Respuesta

La respuesta envuelve un objeto de fulfillment en `data`.

```json Éxito theme={null}
{
  "data": {
    "id": "delivery",
    "uid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "merchant_id": "c1d2e3f4-a5b6-7890-cdef-123456789abc",
    "name": "Delivery",
    "type": "DELIVERY",
    "status": "ACTIVE",
    "channel_ids": ["app", "web", "call-center"]
  }
}
```

## Objeto fulfillment

| Campo | Tipo | Descripción |
| - | - | - |
| `id` | string | Identificador externo de fulfillment. Coincide con el parámetro de ruta. |
| `uid` | string (UUID) | Identificador interno de Fire spark. |
| `merchant_id` | string (UUID) | Comercio al que pertenece la opción de fulfillment. |
| `name` | string | Nombre para mostrar. 1–100 caracteres. |
| `type` | string | Código del tipo de fulfillment. 1–100 caracteres. Valores comunes: `DELIVERY`, `PICKUP`, `DINE_IN`. También se admiten códigos personalizados. |
| `status` | string | `ACTIVE` o `INACTIVE`. |
| `channel_ids` | string\[] | Identificadores externos de canales donde este fulfillment está disponible. Vacío significa inaccesible en todos los canales. |

## Respuestas de error

| Estado | Descripción |
| - | - |
| `401` | Access token ausente o inválido. |
| `403` | El token no incluye el scope `fulfillment:read`. |
| `404` | No existe una opción de fulfillment con el `id` indicado, o no está disponible para `channel_id`. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.