--- updatedAt: 2026-06-19T16:07:00.000Z --- # Create order (Shopify) Creates a new order in the shopify store. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "version": "1.0.0", "title": "Shopify" }, "servers": [ { "url": "https://api.ecartapi.com/api/v2" } ], "paths": { "/orders": { "post": { "summary": "Create order (Shopify)", "description": "Creates a new order in the shopify store.", "operationId": "create_order_shopify", "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean", "example": true }, "order": { "type": "object", "properties": { "id": { "type": "string" }, "number": { "type": "string" }, "email": { "type": "string" }, "fulfillmentStatus": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "status": { "type": "string" }, "partiallAvailable": { "type": "string" } } }, "currency": { "type": "string" }, "totals": { "type": "object", "properties": { "discount": { "type": "string" }, "subtotal": { "type": "string" }, "total": { "type": "string" }, "taxes": { "type": "string" }, "shipping": { "type": "string" }, "quantity": { "type": "string" } } }, "status": { "type": "object", "properties": { "id": { "type": "string", "nullable": true }, "status": { "type": "string" } } }, "payment": { "type": "object", "properties": { "status": { "type": "string" }, "method": { "type": "string" } } }, "customer": { "type": "object", "properties": { "id": { "type": "string" }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "email": { "type": "string" } } }, "billingAddress": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "email": { "type": "string", "nullable": true }, "phone": { "type": "string", "nullable": true }, "address1": { "type": "string" }, "address2": { "type": "string", "nullable": true }, "country": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" } } }, "state": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" } } }, "city": { "type": "string" }, "postalcode": { "type": "string" }, "company": { "type": "string", "nullable": true } } }, "shippingAddress": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "email": { "type": "string", "nullable": true }, "phone": { "type": "string", "nullable": true }, "address1": { "type": "string" }, "address2": { "type": "string", "nullable": true }, "country": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" } } }, "state": { "type": "object", "properties": { "name": { "type": "string" }, "code": { "type": "string" } } }, "city": { "type": "string" }, "postalcode": { "type": "string" }, "company": { "type": "string", "nullable": true } } }, "shippingMethod": { "type": "string", "nullable": true }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "productId": { "type": "string" }, "variantId": { "type": "string" }, "name": { "type": "string" }, "sku": { "type": "string", "nullable": true }, "quantity": { "type": "string" }, "price": { "type": "string" }, "discount": { "type": "string" }, "taxes": { "type": "string" }, "total": { "type": "string" }, "fulfillmentStatus": { "type": "string", "nullable": true }, "fulfillableQuantity": { "type": "string" }, "requireShipping": { "type": "string" } } } }, "packages": { "type": "array", "items": { "type": "object" } }, "dates": { "type": "object", "properties": { "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "paidAt": { "type": "string", "nullable": true }, "cancelledAt": { "type": "string", "nullable": true }, "closedAt": { "type": "string", "nullable": true } } }, "tags": { "type": "array", "items": { "type": "string" } }, "note": { "type": "string", "nullable": true } } } } }, "examples": { "OK": { "summary": "OK", "value": { "success": true, "order": { "id": "6155524341929", "number": "1125", "marketPlaceId": null, "groupId": null, "name": "#1125", "packsId": null, "email": null, "fulfillmentStatus": { "id": null, "status": "UNFULFILLED", "ecartapi": "unfulfilled", "ecartapiId": "3", "partiallAvailable": "true" }, "currency": "MXN", "currencyExtension": "MXN", "discountsCoupon": [ { "type": "fixed_amount", "codeCupon": "Fixed Total Discount", "discount": "", "discountAmount": "10.0" } ], "totals": { "subtotal": "15.25", "discount": "10.0", "shipping": "0.0", "otherFees": null, "tax": "0.0", "weight": "10.00", "total": "15.25" }, "dimensions": { "width": null, "height": null, "length": null }, "totalsExtension": { "subtotal": "15.25", "discount": "10.0", "shipping": "0.0", "tax": "0.0", "total": "15.25" }, "taxesIncluded": "false", "taxLines": [], "units": { "weight": "kg" }, "status": { "id": null, "status": "open", "financial": "PENDING", "ecartapi": "pending", "ecartapiId": "2" }, "locationId": null, "reference": null, "tags": [], "payment": { "method": "", "status": "pending", "ecartapi": null }, "customer": {}, "refunds": [], "billingAddress": { "id": "13305231671465", "firstName": "Alex", "lastName": "de la Cruz", "dni": null, "identificationNumber": null, "address1": "123 Fake Street", "address2": null, "interiorNumber": null, "address3": null, "country": { "code": "CA", "name": "Canada", "codeIso2": "CA", "codeIso3": "CAN" }, "state": { "code": "ON", "name": "Ontario", "codeIso2": "ON", "codeIso3": null }, "city": "Fakecity", "postalCode": "K2P 1L4", "phone": "555-555-5555", "email": null, "company": "envia.com", "references": null, "latitude": null, "longitude": null }, "logistic": { "mode": null, "type": null, "free": "false", "direction": null, "serviceId": null }, "shippingMethod": "Shipping", "shippingOptionReference": "custom", "shippingLabel": null, "documents": { "shippingLabels": [] }, "shippingAddress": { "id": "13305231573161", "firstName": "John", "lastName": "Silver", "dni": null, "identificationNumber": null, "address1": "123 Fake Street", "address2": null, "interiorNumber": null, "address3": null, "country": { "code": "CA", "name": "Canada", "codeIso2": "CA", "codeIso3": "CAN" }, "state": { "code": "ON", "name": "Ontario", "codeIso2": "ON", "codeIso3": null }, "city": "Fakecity", "postalCode": "K2P 1L4", "phone": "555-555-5555", "email": null, "company": "envia.com", "references": null, "latitude": null, "longitude": null }, "items": [ { "id": "14675936772265", "variantId": "45457380049065", "productId": "8434973409449", "offerId": null, "inventoryId": "47561984639145", "sku": "GraphQL-K1.2", "productType": null, "fulfillment": { "quantity": "1", "service": "Manual", "status": "unfulfilled" }, "name": "Product Test K GraphQL 1.2 - L", "upc": null, "requiresShipping": "false", "quantity": "1", "currentQuantity": "1", "salePrice": null, "price": "25.25", "priceExtension": "25.25", "discount": "10.00", "discountExtension": "10.00", "associatedItems": [], "bundled": "false", "tax": null, "taxable": "false", "weight": "10.00", "length": null, "width": null, "height": null, "units": { "weight": "kg", "length": null, "width": null, "height": null }, "vendor": "K2", "imageUrl": null, "ecartapiUrl": "http://localhost:3000/api/v2/products/8434973409449" } ], "packages": [ { "id": "7359738118313", "fulfillmentOrderId": "7359738118313", "number": "#1125", "locationId": "68202987689", "type": "default", "logisticMode": null, "shipmentType": "NONE", "shippingMethod": "custom", "status": "OPEN", "dates": { "createdAt": "2025-04-08T04:14:42Z", "updatedAt": "2025-04-08T04:14:42Z", "labelAvailableAt": "2025-04-08T04:00:00Z" }, "ecartapiUrl": "http://localhost:3000/api/v2/packages/7359738118313" } ], "meta": null, "dates": { "estimatedDeliveryIn": null, "deliveredAt": null, "canceledAt": null, "closedAt": null, "createdAt": "2025-04-08T04:14:42Z", "updatedAt": "2025-04-08T04:14:42Z", "paidAt": "2025-04-08T04:14:42Z" }, "cancelReason": null, "note": null, "locations": [ { "id": "68202987689", "fulfillmentOrderId": "7359738118313", "packageId": null, "locationName": "Vasconcelos 1400", "status": "OPEN", "address1": "Vasconcelos 1400", "address2": null, "country": { "code": "MX", "name": "Mexico", "codeIso2": "MX", "codeIso3": "MEX" }, "state": { "code": "NL", "name": "Nuevo León", "codeIso2": "NL", "codeIso3": "NLE" }, "city": "San Pedro", "postalCode": "66236", "phone": null, "company": null, "references": null, "productIds": [ "14675936772265" ], "default": "false" } ], "localizationExtensions": [], "checkoutId": null, "fraudRisk": null, "events": [], "requiresShipping": false } } } } } } } }, "security": [ { "Authorization": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "order": { "type": "object", "properties": { "email": { "type": "string", "description": "Customer email address." }, "currency": { "type": "string", "description": "Three-letter ISO 4217 currency code." }, "taxesIncluded": { "type": "string" }, "fulfillmentStatus": { "type": "string" }, "reference": { "type": "string", "description": "External order reference." }, "note": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } }, "status": { "type": "object", "properties": { "financial": { "type": "string", "description": "Financial status: paid, pending, etc." } } }, "totals": { "type": "object", "properties": { "subtotal": { "type": "string" }, "discount": { "type": "string" }, "shipping": { "type": "string" }, "tax": { "type": "string" } } }, "payment": { "type": "object", "properties": { "method": { "type": "string", "description": "Payment gateway name." }, "amount": { "type": "string" }, "status": { "type": "string" } } }, "customer": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "phone": { "type": "string" }, "email": { "type": "string" } } }, "billingAddress": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "address1": { "type": "string" }, "address2": { "type": "string" }, "city": { "type": "string" }, "postalCode": { "type": "string" }, "phone": { "type": "string" }, "company": { "type": "string" }, "country": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } }, "state": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } } }, "shippingAddress": { "type": "object", "properties": { "firstName": { "type": "string" }, "lastName": { "type": "string" }, "address1": { "type": "string" }, "address2": { "type": "string" }, "city": { "type": "string" }, "postalCode": { "type": "string" }, "phone": { "type": "string" }, "company": { "type": "string" }, "country": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } }, "state": { "type": "object", "properties": { "code": { "type": "string" }, "name": { "type": "string" } } } } }, "items": { "type": "array", "items": { "type": "object", "properties": { "variantId": { "type": "string" }, "productId": { "type": "string" }, "sku": { "type": "string" }, "name": { "type": "string" }, "quantity": { "type": "string" }, "price": { "type": "string" }, "discount": { "type": "string" }, "taxable": { "type": "string" } } } }, "shippingLines": { "type": "object", "properties": { "title": { "type": "string" }, "price": { "type": "string" }, "method": { "type": "string" }, "carrier": { "type": "string" } } } } } } }, "examples": { "Minimal": { "summary": "Minimal order", "value": { "order": { "email": "enrique.carreon@ecart.com", "currency": "MXN", "taxesIncluded": "false", "status": { "financial": "paid" }, "tags": [ "Enmotive", "imported" ], "customer": { "firstName": "Alex", "lastName": "de la Cruz", "phone": "1122334455", "email": "enrique.carreon@ecart.com" }, "totals": { "tax": "92", "discount": "20" }, "payment": { "method": "EcartAPI-123", "amount": "672", "status": "success" }, "billingAddress": { "firstName": "Alex", "lastName": "de la Cruz", "address1": "123 Fake Street", "country": { "code": "CA", "name": "Canada" }, "state": { "code": "ON", "name": "Ontario" }, "city": "Fakecity", "postalCode": "K2P 1L4", "phone": "555-555-5555", "company": "envia.com" }, "shippingAddress": { "firstName": "Alma", "lastName": "Ramona", "address1": "123 Fake Street", "country": { "code": "CA", "name": "Canada" }, "state": { "code": "ON", "name": "Ontario" }, "city": "Fakecity", "postalCode": "K2P 1L4", "phone": "555-555-5555", "company": "envia.com" }, "items": [ { "variantId": "39625355460652", "name": "Product 1", "quantity": "1", "price": "500", "discount": "0", "taxable": "false" }, { "variantId": "45640943861804", "name": "Product 2", "quantity": "1", "price": "100", "discount": "0", "taxable": "false" } ] } } } } } } } } } }, "components": { "securitySchemes": { "Authorization": { "type": "apiKey", "in": "header", "name": "Authorization", "description": "Used to authenticate API requests after completing the store authorization or integration process. The access_token is generated once the e-commerce store grants access and must be included in every request header to validate the authorized connection." } } }, "x-readme": { "explorer-enabled": true, "proxy-enabled": true }, "security": [ { "Authorization": [] } ] } ```