Order


Representa a una orden o pedido de un cliente.

Los pedidos finalizados son archivados al final del día (12am) del horario local. El valor deleted_at es actualizado con la fecha de archivado.

el objeto status_info ahora está deprecado. Por favor, remapear con las variables en el modelo base:

status_info base descripción
is_service is_service Tipo servicio
is_asap is_asap De Entrega Inmediata
- is_type_digital Pedido de productos digitales
is_pickup_enabled is_pickup_enabled Contiene dirección de recogida
is_provider_required is_delivery && !is_for_shipping Requiere un repartidor
is_shopper_allowed is_shopper_allowed Permite asignar shoppers
is_for_shipping is_for_shipping Es un envío por terceros (MRW, Zoom, Etc)
is_archived deleted_at != null Está archivada
shopper_assigned is_shopper_assigned Shopper asignado
provider_assigned is_provider_assigned Repartidor asignado
provider_started is_provider_started Repartidor camino al comercio
provider_arrived is_provider_arrived Repartidor en el comercio
provider_collected is_provider_collected Repartidor camino al destino
provider_working is_provider_working Provider prestando un servicio
payment_later is_payment_later Pagará en la entrega
payment_waiting_confirmation is_payment_waiting_confirmation Confirmando pago
payment_confirmed is_payment_confirmed Pago exitoso
bid_waiting_client is_bid_waiting_client Comprador eligiendo provider
bid_waiting_provider is_bid_waiting_provider Provider confirmado asignación
bid_waiting_admin is_bid_waiting_admin Admin confirmando asignación
order_is_confirmed !is_status_unconfirmed Orden confirmada
order_being_prepared is_status_being_prepared Comercio inició preparación
order_prepared is_status_prepared Comercio listo para entregar
order_arrived is_status_arrived En destino, listo para entregar
order_finished is_status_completed Orden finalizada
- is_status_completed_ok Orden entregada
order_canceled is_status_canceled Orden cancelada
order_expired is_status_expired Orden expirada
order_refund_pending is_refund_pending Reembolso pendiente
order_refund_applied is_refund_applied Reembolso realizado
pool_is_private is_pool_private Maneja Providers del comercio
- is_invoice_allowed Válido para pagar al comercio

Modelo Order

Ver Json

Atributo Tipo Descripción
id int -
number int\|null -
status int -
subtotal_e2 int -
total_e2 int -
tax_e2 int -
client_latitude_e6 int -
client_longitude_e6 int -
client_address_data array\|null -
pickup_latitude_e6 int -
pickup_longitude_e6 int -
completed_at datetime\|null -
deleted_at datetime\|null -
created_at datetime\|null -
updated_at datetime\|null -
company_id int -
client_id int\|null -
branch_id int\|null -
uid string\|null -
receiver_name string\|null -
receiver_phone string\|null -
is_gift bool\|null -
currency_iso string\|null -
branch_group_id int\|null -
subtotal_original_e2 int\|null -
ordered_goods array\|null -
is_service bool BitMask (({@link self::status} & 0x1) !== 0)
is_pickup_enabled bool BitMask (({@link self::status} & 0x2) !== 0)
is_type_digital bool BitMask (({@link self::status} & 0x4) !== 0)
is_delivery bool BitMask (({@link self::status} & 0x8) !== 0)
is_bid_waiting_client bool BitMask (({@link self::status} & 0x10) !== 0)
is_bid_waiting_admin bool BitMask (({@link self::status} & 0x20) !== 0)
is_bid_waiting_provider bool BitMask (({@link self::status} & 0x40) !== 0)
is_asap bool BitMask (({@link self::status} & 0x80) !== 0)
is_status_unconfirmed bool BitMask (({@link self::status} & 0x100) !== 0)
is_payment_waiting_confirmation bool BitMask (({@link self::status} & 0x200) !== 0)
is_payment_confirmed bool BitMask (({@link self::status} & 0x400) !== 0)
is_provider_assigned bool BitMask (({@link self::status} & 0x800) !== 0)
is_provider_started bool BitMask (({@link self::status} & 0x1000) !== 0)
is_status_arrived bool BitMask (({@link self::status} & 0x2000) !== 0)
is_provider_working bool BitMask (({@link self::status} & 0x4000) !== 0)
is_status_completed bool BitMask (({@link self::status} & 0x8000) !== 0)
is_status_canceled bool BitMask (({@link self::status} & 0x10000) !== 0)
is_status_completed_ok bool BitMask (({@link self::status} & 0x20000) !== 0)
is_refund_applied bool BitMask (({@link self::status} & 0x40000) !== 0)
is_refund_pending bool BitMask (({@link self::status} & 0x80000) !== 0)
is_payment_later bool BitMask (({@link self::status} & 0x100000) !== 0)
is_status_being_prepared bool BitMask (({@link self::status} & 0x200000) !== 0)
is_status_prepared bool BitMask (({@link self::status} & 0x400000) !== 0)
is_provider_arrived bool BitMask (({@link self::status} & 0x800000) !== 0)
is_provider_collected bool BitMask (({@link self::status} & 0x1000000) !== 0)
is_status_expired bool BitMask (({@link self::status} & 0x2000000) !== 0)
is_shopper_allowed bool BitMask (({@link self::status} & 0x4000000) !== 0)
is_shopper_assigned bool BitMask (({@link self::status} & 0x8000000) !== 0)
is_pool_private bool BitMask (({@link self::status} & 0x10000000) !== 0)
is_invoice_allowed bool BitMask (({@link self::status} & 0x20000000) !== 0)
is_for_shipping bool BitMask (({@link self::status} & 0x40000000) !== 0)
has_item_updates bool BitMask (({@link self::status} & 0x80000000) !== 0)
is_sent_to_pool bool BitMask (({@link self::status} & 0x100000000) !== 0)
administrator_notes Collection -
client_rating_e2 int -
company_currency_snapshot Currency\|null -
currency_snapshot Currency\|null -
delivery_fee_to_pay_e2 int -
latest_status string -
order_provider_snapshot OrderProvider\|null -
probable_eta datetime\|null -
shopper_attachments Collection -
shopper_notes Collection -
status_data array -
status_for_branch_admins string -
status_for_clients string -
status_for_company_admins string -
status_for_payment string -
status_for_providers string -
status_for_shoppers string -

Insertar Order

Insertar Order de Client

Store a newly created resource in storage.

Método URI Cabeceras
POST /companies/{companyId}/branches/{branchId}/clients/{clientId}/orders Authorization
{
    "receiver_name": "string|max:64",
    "receiver_phone": "string|max:32",
    "client_dni": "string|max:32",
    "client_phone": "string|max:32",
    "client_name": "string|max:128",
    "client_email": "string|email:rfc,filter",
    "is_gift": "boolean",
    "client_latitude_e6": "required_without:client_address_id|integer|between:-90000000,90000000",
    "client_longitude_e6": "required_with:client_latitude_e6||integer|between:-180000000,180000000",
    "client_address": "string|max:512",
    "client_address_id": "integer",
    "pickup_latitude_e6": "integer|between:-90000000,90000000",
    "pickup_longitude_e6": "integer|between:-180000000,180000000",
    "pickup_address": "string|max:512",
    "provider_id": "integer",
    "scheduled_at": "date",
    "use_local_tz": "boolean",
    "notes": "string|max:255",
    "goods": [
        {
            "good_id": "required|integer|exists:goods,id",
            "quantity": "required|integer|min:1",
            "units": "nullable|numeric|min:0.000001",
            "provider_id": "integer",
            "notes": "string|max:255",
            "properties": [
                {
                    "property_id": "required|integer",
                    "value": "required|string"
                }
            ]
        }
    ],
    "subtotal_e2": "integer|min:0",
    "service_charge_id": "nullable|integer",
    "service_charge": "nullable|array",
    "available_delivery_providers": "nullable|array",
    "use_balance": "boolean",
    "coupon_code": "nullable|string|min:5|max:20",
    "cart_identifier": "integer|min:0",
    "all_errors": "",
    "simulate": "",
    "force_scheduling": "boolean",
    "force_providers": [
        "integer"
    ]
}

Listar Order

{info} Soporta: Paginación Filters Carga dinámica

Display a listing of Orders.

Método URI Cabeceras
GET /companies/{companyId}/orders Authorization

Listar Order de BranchGroup

{info} Soporta: Paginación Filters Carga dinámica

Método URI Cabeceras
GET /companies/{companyId}/branch-groups/{branchGroupId}/orders Authorization

Listar Order de Branch

{info} Soporta: Paginación Filters Carga dinámica

Método URI Cabeceras
GET /companies/{companyId}/branches/{branchId}/orders Authorization

Listar Order de Client

{info} Soporta: Paginación Filters Carga dinámica

Display a listing of the resource.

Método URI Cabeceras
GET /companies/{companyId}/clients/{clientId}/orders Authorization

Display a listing of the resource.

{info} Soporta: Filters

Método URI Cabeceras
GET /companies/{companyId}/clients/{clientId}/orders/active Authorization

Display a listing of the Orders that a Provider can be assigned to.

Método URI Cabeceras
GET /companies/{companyId}/providers/{providerId}/orders/available Authorization

Listar Order de Admin

{info} Soporta: Paginación

Display a listing of the resource.

Método URI Cabeceras
GET /companies/{companyId}/admins/{adminId}/orders Authorization

Display the order histories

Método URI Cabeceras
GET /companies/{companyId}/orders/{orderId}/order-histories Authorization

Mostrar Order

{info} Soporta: Carga dinámica

Display the specified Order.

Método URI Cabeceras
GET /companies/{companyId}/orders/{orderId} Authorization

Actualizar Order

{info} Soporta: Paginación Filters Carga dinámica

Método URI Cabeceras
PATCH /companies/{companyId}/orders/{orderId} Authorization
{
    "admin_note_id": "nullable|integer|min:1",
    "admin_notes": "nullable|string|max:512"
}

Subir imagen a una nota de administrador

{info} Soporta: Paginación Filters Carga dinámica

Crea una evidencia (imagen) y lo vincula a una nota de administrador de una Orden. Se puede visualizar por el atributo de Orden: administrator_notes.attachments

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/add-attachment Authorization
{
    "admin_note_id": "required|integer|min:1",
    "attachment": "required|image|mimes:jpeg,png,bmp|max:8192"
}

Subir notas/adjuntos como Shopper

{info} Soporta: Paginación Filters Carga dinámica

Crea una evidencia (imagen) y una nota (texto) de un shopper y lo vincula a una orden. Útil para subir facturas o evidencias de la compra. Se puede visualizar por el atributo de Orden: shopper_notes. Sólo disponible para el shopper asignado.

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/add-shopper-notes Authorization
{
    "shopper_notes": [
        {
            "text": "nullable|string|max:512",
            "attachments": [
                "required|image|mimes:jpeg,png,bmp|max:8192"
            ]
        }
    ]
}

Acciones de Order

Batch

Método URI Cabeceras
POST /companies/{companyId}/orders/batch-action/{action} Authorization
{
    "ids": [
        "integer|min:1"
    ],
    "payload": ""
}

Handle

Método URI Cabeceras
GET /companies/{companyId}/orders/branch-heatmap Authorization

Set Confirmed

Confirms an Order and puts an Order's number

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-confirmed Authorization

Set Paid

Marks the order as paid

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-paid Authorization
{
    "type": "string|in:gateway,form,post-payment,balance",
    "name": "string",
    "ref": "string"
}

Begin

Begins an Order (changes status to: running).

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-running Authorization

Set Ready

Marks an Order as completed. This only works if the order is not suitable for deliveries.

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-ready Authorization

Complete

Marks an Order as completed. This only works if the order is not suitable for deliveries.

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-completed Authorization

Cancel

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-canceled Authorization
{
    "reason": "required|string|max:64"
}

Post Pay

Marks an Order for Post Payment (Pay in store or pay to provider)

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-post-payment Authorization
{
    "id": "nullable|string",
    "currency_iso": "required_with:id|string|min:3|max:8"
}

Balance Pay

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-balance-payment Authorization

Set Being Prepared

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-being-prepared Authorization

Set Prepared

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-prepared Authorization

Change Pool

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-private-pool Authorization

Change Pool

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-public-pool Authorization

Index Available

Método URI Cabeceras
GET /companies/{companyId}/orders/{orderId}/available-fleets Authorization

Update Fleet

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/set-selected-fleet Authorization
{
    "service_charge_id": "required|integer"
}

Send To Pool

Try order assignment

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/send-to-pool Authorization
{
    "force": "bool"
}

Set Excluded

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/exclude-invoices Authorization

Set Included

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/include-invoices Authorization

Store From Admin

Store a newly created resource in storage.

Método URI Cabeceras
POST /companies/{companyId}/branches/{branchId}/orders Authorization
{
    "receiver_name": "string|max:64",
    "receiver_phone": "string|max:32",
    "client_dni": "string|max:32",
    "client_phone": "string|max:32",
    "client_name": "string|max:128",
    "client_email": "string|email:rfc,filter",
    "is_gift": "boolean",
    "client_latitude_e6": "required_without:client_address_id|integer|between:-90000000,90000000",
    "client_longitude_e6": "required_with:client_latitude_e6||integer|between:-180000000,180000000",
    "client_address": "string|max:512",
    "client_address_id": "integer",
    "pickup_latitude_e6": "integer|between:-90000000,90000000",
    "pickup_longitude_e6": "integer|between:-180000000,180000000",
    "pickup_address": "string|max:512",
    "provider_id": "integer",
    "scheduled_at": "date",
    "use_local_tz": "boolean",
    "notes": "string|max:255",
    "goods": [
        {
            "good_id": "required|integer|exists:goods,id",
            "quantity": "required|integer|min:1",
            "units": "nullable|numeric|min:0.000001",
            "provider_id": "integer",
            "notes": "string|max:255",
            "properties": [
                {
                    "property_id": "required|integer",
                    "value": "required|string"
                }
            ]
        }
    ],
    "subtotal_e2": "integer|min:0",
    "service_charge_id": "nullable|integer",
    "service_charge": "nullable|array",
    "available_delivery_providers": "nullable|array",
    "use_balance": "boolean",
    "coupon_code": "nullable|string|min:5|max:20",
    "cart_identifier": "integer|min:0",
    "all_errors": "",
    "simulate": "",
    "force_scheduling": "boolean",
    "force_providers": [
        "integer"
    ]
}

Assign

Método URI Cabeceras
PUT /companies/{companyId}/orders/{orderId}/shoppers/{providerId} Authorization

Unassign

Método URI Cabeceras
DELETE /companies/{companyId}/orders/{orderId}/shoppers/{providerId} Authorization

Insert

Método URI Cabeceras
POST /companies/{companyId}/orders/{orderId}/adjust Authorization

Enlaces de Order