Delitbee – Admin Rest-API

Delitbee cuenta con una api para obtener pedidos y repartos con una información similar a la ofrecida en nuestro portal.

Autenticación

Todas las llamadas a la api deberán indicar el header Authentication

Authentication: Bearer a9c6d041-13c1-490a-a227-xxxxxxxxxxxx

El token (Clave Api) se obtiene en la sección Balance y Ganancias de nuestro portal

1. Clica en “Generar nueva clave”
   
2. Dale un nombre y copia la clave que aparece en la ventana

Info General

• Los precios se retornan en números enteros representando centimos. Por ejemplo 456 serían a 4,56€
• Posibles valores de orderStatus:
  • scheduled: Pedido programado por el cliente o esperando rider asignado
  • processed: Pedido ya introducido en el channel manager
  • kitchen: Pedido en preparación (solo aparece si lo informa el channel manager)
  • ready: Pedido listo (solo aparece si lo informa el channel manager)
  • delivering: Pedido en reparto (informado por las integraciones de reparto)
  • delivered: Pedido entregado (informado por las integraciones de reparto)
  • error: Pedido no introducido en channel manager debido a un error.
  • cancelled: Pedido cancelado (solo se puede cancelar mientras esta programado)
  • rejected: Pedido rechazado (solo para pedidos con pago en cash en el local)
• Posibles valores de paymentStatus:
  • ready_to_capture: Aprobado por el cliente pero no “capturado” todavía. Este estado sucede mientras un pedido está programado.
  • executing: Mientras el pago se está “capturando”
  • succeeded: Pago capturado
  • cancelled: Pago cancelado antes de ser capturado. Sucede cuando se cancela un pedido programado.
  • refunded: Pago completamente reembolsado
  • partially_refunded: Pago parcialmente reembolsado
  • disputed: Pago con disputa bancaria
• Valores relevantes de deliveryStatus:
  • created: Reparto creado en el servicio de reparto, aun no se ha asignado repartidor.
  • assigned: Repartidor asignado
  • picking: En proceso de recogida
  • waiting_at_pickup: Esperando para la recogida
  • delivering: En reparto
  • waiting_at_delivery: Esperando en la zona de entrega
  • delivered: Entregado
  • failed | cancelled : Aplicado por el servicio de entregas, fallido o cancelado en función de distintas casuísticas.

Endpoints

Listado de pedidos

• Dirección: https://api.delitbee.com/papi/v1/orders
• Parámetros query opcionales:
  • pickup_after=2026-02-15T23:15:11Z → Pickup after indica la fecha minima de los pedidos que queremos obtener.
  • pickup_before=2026-02-15T23:15:11Z → Pickup before indica la fecha máxima de los pedidos que queremos obtener.
  • Parámetros de paginación:
    • page=1 → Pagina de resultados, comienza por 1
    • page_size=100 → Resultados en cada página, máximo 100
• Ejemplo: https://api.delitbee.com/papi/v1/orders?pickup_after=2026-02-15T05:00:00Z&pickup_before=2026-02-21T05:00:00Z&page=1&page_size=100
  • Pedidos comprendidos entre el día 15 de Febrero a las 5am (UTC) y el 21 de Febrero a las 5am (UTC)

Formato respuesta

{
    "success": true,
    "result": [
        {
            "orderId": "8d34f89f-3ee7-4001-be87-xxxxxxxxxxxx",
            "orderCode": "DTB00000",
            "orderType": "collection",
            "orderStatus": "processed",
            "restaurantId": "my-restaurant-id",
            "restaurantName": "Nombre Restaurante",
            "products": [
                {
                    "id": "1122873",
                    "name": "Kas limón",
                    "quantity": 1,
                    "price": 250
                },
                {
                    "id": "1122952",
                    "name": "Producto combo",
                    "subProducts": [
                        {
                            "id": "3805290",
                            "name": "Caprichosa",
                            "quantity": 1,
                            "price": 0
                        },
                        {
                            "id": "3805320",
                            "name": "Carbonara",
                            "quantity": 1,
                            "price": 0
                        }
                    ],
                    "quantity": 1,
                    "price": 1490
                }
            ],
            "customer": {
                "name": "John Doe",
                "phone": "666111222",
                "email": "johndoe@gmail.com"
            },
            "payment": {
                "orderAmount": 1740,
                "deliveryFeeAmount": 0,
                "discountAmount": 0,
                "cashbackAmount": 0,
                "tipAmount": 0,
                "customFeeAmount": 0,
                "totalAmount": 1740,
                "paymentMethod": "stripe",
                "paymentStatus": "succeeded" // 
            },
            "timings": {
                "checkoutTime": "2026-02-23T23:18:10+01:00",
                "scheduledPickupTime": "2026-02-23T23:33:00+01:00"
            },
            "billing": {
                "transactionFee": 66,
                "deliveryFee": 0,
                "totalFee": 66,
                "stripe": {
                    "transferId": "tr_xxxxxxxxxxxxxxxxx",
                    "amountTransferred": 1660
                }
            }
        },
        {
            "orderId": "897d770d-d31c-48e2-8f92-xxxxxxxxxxxx",
            "orderCode": "DTB000001",
            "orderType": "delivery",
            "orderStatus": "delivered",
            "restaurantId": "my-restaurant-id",
            "restaurantName": "Nombre restaurante",
            "products": [
                {
                    "id": "1122952",
                    "name": "Product combo",
                    "subProducts": [
                        {
                            "id": "3805292",
                            "name": "Capriciosa",
                            "quantity": 1,
                            "price": 0
                        },
                        {
                            "id": "3805312",
                            "name": "A la Miel",
                            "quantity": 1,
                            "price": 0
                        }
                    ],
                    "quantity": 1,
                    "price": 1490
                }
            ],
            "customer": {
                "name": "Some name",
                "phone": "600111222",
                "email": "someperson@gmail.com"
            },
            "deliveryAddress": {
                "address": "Avenida de la calle falsa, 52, 34000, Ciudad, Ciudad",
                "doorInfo": "Piso 7 puerta 14"
            },
            "payment": {
                "orderAmount": 1490,
                "deliveryFeeAmount": 399,
                "discountAmount": 0,
                "cashbackAmount": 0,
                "tipAmount": 0,
                "customFeeAmount": 0,
                "totalAmount": 1889,
                "paymentMethod": "stripe",
                "paymentStatus": "succeeded"
            },
            "timings": {
                "checkoutTime": "2026-02-23T23:00:42+01:00",
                "scheduledPickupTime": "2026-02-23T23:15:00+01:00",
                "scheduledDeliveryTime": "2026-02-23T23:45:00+01:00"
            },
            "billing": {
                "transactionFee": 70,
                "deliveryFee": 465,
                "totalFee": 535,
                "stripe": {
                    "transferId": "tr_xxxxxxxxxxxxxxxx",
                    "amountTransferred": 1242
                }
            }
        }
    ]
}

Listado de repartos

• Dirección: https://api.delitbee.com/papi/v1/deliveries
• Parámetros query opcionales:
  • pickup_after=2026-02-15T23:15:11Z → Pickup after indica la fecha mínima de los repartos que queremos obtener.
  • pickup_before=2026-02-15T23:15:11Z → Pickup before indica la fecha máxima de los repartos que queremos obtener.
  • Parámetros de paginación:
    • page=1 → Pagina de resultados, comienza por 1
    • page_size=100 → Resultados en cada página, máximo 100
• Ejemplo: https://api.delitbee.com/papi/v1/deliveries?pickup_after=2026-02-15T05:00:00Z&pickup_before=2026-02-21T05:00:00Z&page=1&page_size=100
  • Repartos comprendidos entre el día 15 de Febrero a las 5am (UTC) y el 21 de Febrero a las 5am (UTC)

Formato respuesta

{
    "success": true,
    "result": [
        {
            "deliveryId": "ed9cc6a5-ab4e-40a5-af2a-xxxxxxxxxxxx",
            "deliveryMethod": "uber",
            "deliveryStatus": "delivered",
            "orderId": "897d770d-d31c-48e2-8f92-xxxxxxxxxxxx",
            "orderCode": "DTB00000",
            "restaurantId": "restaurant-id",
            "restaurantName": "Nombre restaurante",
            "driver": {
                "name": "IMRAN S.",
                "phoneNumber": "+34910780961",
                "phoneCode": "53569035",
                "trackingUrl": "https://delivery.uber.com/es/orders/9785e220-e7b8-432a-b98e-xxxxxxxxxxxx?ptr=delitbee"
            },
            "timings": {
                "requestedPickupTime": "2026-02-23T23:15:42+01:00",
                "actualPickupTime": "2026-02-23T23:15:42+01:00",
                "requestedDropoffTime": "2026-02-23T23:45:42+01:00",
                "actualDropoffTime": "2026-02-23T23:45:42+01:00"
            },
            "billing": {
                "price": 465
            }
        }
    ]
}