Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ivorpad/mercadona-cli/llms.txt

Use this file to discover all available pages before exploring further.

mercadona checkout create converts your current cart into a checkout object, returning a checkout ID and default delivery address. This is reversible — creating a checkout reserves nothing and costs nothing. Only checkout submit places a real order.

​
Synopsis

mercadona checkout create [flags]
mercadona checkout addresses
mercadona checkout get --checkout <id>

​
Flags

FlagDefaultDescription
--max <eur>0 / env / configRefuse if checkout total exceeds this amount
--wh <code>config / mad1Warehouse code
--jsonfalseEmit raw checkout JSON

​
Example Flow

# Create checkout and capture ID
mercadona checkout create --json --max 80

# List saved delivery addresses
mercadona checkout addresses

# View an existing checkout
mercadona checkout get --checkout <id>

​
JSON Output Shape

When --json is passed, the response includes the checkout ID, the embedded default delivery address, and the order summary: 
{
  "id": "<checkout-id>",
  "address": {
    "id": 12345,
    "street": "Calle Mayor 1",
    "city": "Madrid"
  },
  "summary": {
    "total": "18.56"
  }
}
Orders below 60€ are rejected by the Mercadona API. When your basket is under this threshold, checkout create prints a warning to stderr — faltan X€ para el mínimo — so that --json stdout remains clean and parseable. The delivery fee (~8.20€) is added on top once a slot is chosen, so the minimum applies to the product subtotal alone.
Delivery slots are not returned by checkout create. They hang off the delivery address, not the checkout. Fetch them separately with checkout slots --address <id> after capturing the address ID from the create response.
Size --max to cover the product subtotal plus the delivery fee (~8.20€). A basket that fits within --max 80 at cart time should use --max 90 at checkout, since the slot price is added when you run checkout set-delivery.

Build docs developers (and LLMs) love

Get started for freeTalk to us