Create order

POST

/v2/orders

curl --request POST \
  --url https://api.orderfast.com.ar/v2/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: example' \
  --header 'idempotency-key: example' \
  --data '{ "external_id": "erp-order-1001", "channel": "erp", "is_take_away": true, "identifier": "Mesa 12", "items": [ { "product_id": "prod_9f03", "quantity": 2, "comment": "Sin cebolla", "subselections": [ { "item_id": "item_1", "quantity": 1 }, { "item_id": "item_1", "quantity": 1 } ] }, { "product_id": "prod_9f03", "quantity": 2, "comment": "Sin cebolla", "subselections": [ { "item_id": "item_1", "quantity": 1 }, { "item_id": "item_1", "quantity": 1 } ] } ], "payment_method_id": "pm_123" }'

• Production
• Testing
• Local

Requires Idempotency-Key. Payment status in responses uses completed (maps from DB completed).

Authorizations

• api-key

Parameters

Header Parameters

idempotency-key

required

string

Idempotency-Key

required

string

Unique key to safely retry order creation

Request Body^required

Media typeapplication/json

object

external_id

required

string

Example

erp-order-1001

channel

string

Example

erp

is_take_away

required

boolean

Example

true

identifier

required

string

Example

Mesa 12

items

required

Array<object>

object

product_id

required

string

Example

prod_9f03

quantity

required

number

Example

2

comment

string

Example

Sin cebolla

subselections

Array<object>

object

item_id

required

string

Example

item_1

quantity

required

number

Example

1

Example

{
  "item_id": "item_1",
  "quantity": 1
}

Example

{
  "product_id": "prod_9f03",
  "quantity": 2,
  "comment": "Sin cebolla",
  "subselections": [
    {
      "item_id": "item_1",
      "quantity": 1
    },
    {
      "item_id": "item_1",
      "quantity": 1
    }
  ]
}

payment_method_id

required

string

Example

pm_123

Example

{
  "external_id": "erp-order-1001",
  "channel": "erp",
  "is_take_away": true,
  "identifier": "Mesa 12",
  "items": [
    {
      "product_id": "prod_9f03",
      "quantity": 2,
      "comment": "Sin cebolla",
      "subselections": [
        {
          "item_id": "item_1",
          "quantity": 1
        },
        {
          "item_id": "item_1",
          "quantity": 1
        }
      ]
    },
    {
      "product_id": "prod_9f03",
      "quantity": 2,
      "comment": "Sin cebolla",
      "subselections": [
        {
          "item_id": "item_1",
          "quantity": 1
        },
        {
          "item_id": "item_1",
          "quantity": 1
        }
      ]
    }
  ],
  "payment_method_id": "pm_123"
}

Responses

200

Successful response

Media typeapplication/json

object

data

required

object

id

required

string

number

required

number

status

required

string

Allowed values: pending canceled ready closed

total

required

number

created_at

required

string

payment

required

object

id

required

string

status

required

string

Allowed values: pending completed canceled refunded error

external_id

string

channel

string

is_take_away

boolean

identifier

string

items

required

Array<object>

object

product_id

required

string

quantity

required

number

comment

string

subselections

Array<object>

object

item_id

required

string

quantity

required

number

payment_method_id

string

Examples

Examplesuccess

Successful response

{
  "data": {
    "id": "ord_123",
    "number": 24445,
    "status": "pending",
    "total": 21100,
    "created_at": "2026-07-06T11:08:26.085497-03:00",
    "payment": {
      "id": "pay_123",
      "status": "completed"
    },
    "external_id": "erp-order-1001",
    "is_take_away": true,
    "identifier": "Mesa 12",
    "payment_method_id": "pm_123",
    "items": [
      {
        "product_id": "prod_9f03",
        "external_product_id": "erp-product-1001",
        "quantity": 2,
        "comment": "Sin cebolla",
        "subselections": [
          {
            "item_id": "item_1",
            "quantity": 1
          }
        ]
      }
    ],
    "channel": "erp"
  }
}

401

Unauthorized — missing or invalid API key

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error

message

required

string

request_id

required

string

Examples

Exampleunauthorized

Invalid API key

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key",
    "request_id": "req_01J..."
  }
}

403

Permission denied

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error

message

required

string

request_id

required

string

Examples

Examplepermission_denied

Missing permission

{
  "error": {
    "code": "permission_denied",
    "message": "The API key does not have the required permission",
    "request_id": "req_01J..."
  }
}

409

Conflict

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error

message

required

string

request_id

required

string

Examples

Exampleconflict

Conflict / idempotency mismatch

{
  "error": {
    "code": "conflict",
    "message": "Idempotency-Key was already used with a different request body",
    "request_id": "req_01J..."
  }
}

422

Validation error

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error

message

required

string

request_id

required

string

Examples

Examplevalidation_error

Invalid body or query

{
  "error": {
    "code": "validation_error",
    "message": "One or more fields failed validation",
    "request_id": "req_01J..."
  }
}

500

Internal server error

Media typeapplication/json

object

error

required

object

code

required

string

Allowed values: invalid_request unauthorized permission_denied resource_not_found conflict validation_error rate_limited internal_error

message

required

string

request_id

required

string

Examples

Exampleinternal_error

Unexpected failure

{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred",
    "request_id": "req_01J..."
  }
}