Saltar al contenido
PedidosPedidos

Cancelar pedido con reembolso

Cancela el pedido, reembolsa los pagos indicados e informa si ambos terminaron.

Parámetros de ruta

orderId*string

Identificador del pedido.

Parámetros de cabecera

x-Store-Id?string

Tienda sobre la que actúa la solicitud. No hace falta cuando el token ya está vinculado a una tienda.

Authorization*string

Token bearer OAuth 2.0.

Cuerpo de la solicitud

application/json

Definiciones TypeScript

Usa esta definición en TypeScript.

Cuerpo de la respuesta

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.ecomiq.pe/api/v1/orders/7204558912004325350/cancel-with-refund" \  -H "x-Store-Id: <store-id>" \  -H "Authorization: Bearer <token>" \  -H "Content-Type: application/json" \  -d '{    "payments": [      {        "paymentTransactionId": "7204558912004324696",        "amount": 178      }    ],    "idempotencyKey": "pedido-2026-0001",    "shippingAmount": 0,    "cancelReason": "Reposición de stock.",    "cancelReasonType": "Reposición de stock.",    "notifyCustomer": true  }'
{  "order": {    "id": "7204558912004325350",    "storeId": "7204558912004327977",    "cartId": "7204558912004325176",    "orderDraftId": "7204558912004324619",    "customerId": "7204558912004326262",    "orderNumber": "ORD-2026-0001",    "orderShortId": "7204558912004321350",    "couponCode": "BIENVENIDA10",    "origin": "checkout",    "sourceIdentifier": "ERP-0001",    "orderGroup": "ORD-2026-0001",    "notes": "Entregar después de las 18:00.",    "phone": "+51987654321",    "email": "andrea.ramos@example.com",    "firstName": "Andrea",    "lastName": "Ramos",    "identificationType": "DNI",    "identificationNumber": "45678912",    "entityTaxId": "7204558912004326352",    "entityName": "Comercial Lima SAC",    "promotion": "Bienvenida 10 %",    "shippingPromotion": "Envío gratis desde S/ 150",    "totalSkus": 24,    "shippingConnectionId": "7204558912004329148",    "orderDate": "2026-09-28T15:30:00Z",    "preOrderDate": "2026-09-28T15:30:00Z",    "confirmedAt": "2026-09-28T15:30:00Z",    "inProgressAt": "2026-09-28T15:30:00Z",    "paymentAt": "2026-09-28T15:30:00Z",    "shippingAt": "2026-09-28T15:30:00Z",    "closedAt": "2026-09-28T15:30:00Z",    "cancelledAt": "2026-09-28T15:30:00Z",    "completedAt": "2026-09-28T15:30:00Z",    "conciliationAt": "2026-09-28T15:30:00Z",    "invoicedAt": "2026-09-28T15:30:00Z",    "inTransitAt": "2026-09-28T15:30:00Z",    "pickupAt": "2026-09-28T15:30:00Z",    "returnedAt": "2026-09-28T15:30:00Z",    "invalidAt": "2026-09-28T15:30:00Z",    "status": "new",    "state": "open",    "fulfillmentStatus": "unfulfilled",    "returnStatus": "none",    "shippingType": "delivery",    "invoiceType": "ticket",    "sellerId": "7204558912004323447",    "tags": "algodón",    "integrationTags": "erp",    "cancelReason": "Reposición de stock.",    "cancelReasonType": "Reposición de stock.",    "currencyCode": "PEN",    "subTotal": 178,    "discount": 10,    "shipping": 1,    "extraShippingCost": 40,    "tax": 1,    "warranty": 1,    "total": 178,    "assignee": {      "memberId": "7204558912004324722",      "name": "Andrea Ramos",      "email": "andrea.ramos@example.com"    },    "attachments": "https://mi-tienda.ecomiq.app/files/guia-de-tallas.pdf",    "invoiceNumber": "F001-00012345",    "invoiceLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",    "isSplitSellerItem": false,    "hasRefund": false,    "hasPaymentToConfirm": false,    "hasTrackingNumber": true,    "billingAddress": {      "address1": "Av. Larco 1234",      "city": "Lima",      "countryCode": "PE",      "name": "Mi tienda",      "company": "Comercial Lima SAC",      "address2": "Dpto. 501",      "province": "Lima",      "postalCode": "15074"    },    "shippingAddress": {      "address1": "Av. Larco 1234",      "city": "Lima",      "countryCode": "PE",      "name": "Mi tienda",      "company": "Comercial Lima SAC",      "address2": "Dpto. 501",      "province": "Lima",      "postalCode": "15074"    },    "attribution": {      "campaignId": "7204558912004328792",      "utmSource": "instagram",      "utmMedium": "social",      "utmCampaign": "nueva-temporada",      "referralCode": "AMIGA10"    },    "instructions": {      "giftMessage": "¡Feliz cumpleaños, Andrea!",      "specialInstructions": "20123456789"    },    "items": [      {        "id": "7204558912004325350",        "externalItemId": "7204558912004323678",        "productId": "7204558912004322039",        "categoryId": "7204558912004327982",        "brandId": "7204558912004322959",        "sellerId": "7204558912004323447",        "shippingProfileId": "7204558912004329819",        "variantId": "7204558912004323197",        "skuId": "7204558912004326949",        "sku": "POL-001-AZ-M",        "locationId": "7204558912004328277",        "title": "Polo de algodón",        "subtitle": "Polo de algodón",        "thumbnail": "https://mi-tienda.ecomiq.app/images/polo-de-algodon.webp",        "productTitle": "Polo de algodón",        "productDescription": "Polo de algodón pima para uso diario.",        "productType": "product",        "productCollection": "nueva-temporada",        "productHandle": "polo-de-algodon",        "variantSku": "POL-001-AZ-M",        "variantBarcode": "7751234567892",        "variantTitle": "Polo de algodón",        "variantOptionValues": {},        "brand": "Andina",        "category": "Polos",        "height": 30,        "length": 30,        "width": 30,        "weight": 0.3,        "weightUnit": "kilogram",        "quantity": 2,        "quantityRemaining": 2,        "quantityToDispatch": 2,        "quantityDispatched": 2,        "quantityDelivered": 2,        "quantityRefunded": 2,        "quantityReturned": 2,        "unitPrice": 89,        "subTotal": 178,        "discount": 10,        "shipping": 1,        "tax": 1,        "warranty": 1,        "total": 178,        "sellerCommissionId": "7204558912004322946",        "commissionSource": "seller",        "productCommissionPercent": 10,        "freightCommissionPercent": 10,        "fixedFee": 1,        "commissionBaseAmount": 178,        "productCommissionAmount": 178,        "freightCommissionBaseAmount": 178,        "freightCommissionAmount": 178,        "commissionAmount": 178,        "requiresShipping": false,        "isDiscountable": false,        "isGiftcard": false,        "isTaxInclusive": false,        "isCustomPrice": false,        "shippingConnectionId": "7204558912004329148",        "shippingProviderName": "Polo de algodón",        "shippingCostId": "7204558912004324587",        "shippingCostName": "Polo de algodón",        "invoiceNumber": "F001-00012345",        "invoiceLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",        "trackingNumber": "PE1234567890",        "trackingLink": "https://tracking.example.com/PE1234567890",        "orderItemStatus": "new",        "inProgressAt": "2026-09-28T15:30:00Z",        "paymentAt": "2026-09-28T15:30:00Z",        "shippingAt": "2026-09-28T15:30:00Z",        "closedAt": "2026-09-28T15:30:00Z",        "cancelledAt": "2026-09-28T15:30:00Z",        "completedAt": "2026-09-28T15:30:00Z",        "conciliationAt": "2026-09-28T15:30:00Z",        "invoicedAt": "2026-09-28T15:30:00Z",        "inTransitAt": "2026-09-28T15:30:00Z",        "pickupAt": "2026-09-28T15:30:00Z",        "returnedAt": "2026-09-28T15:30:00Z",        "deliveredAt": "2026-09-28T15:30:00Z",        "modifiers": [          {            "id": "7204558912004325350",            "modifierGroupId": "7204558912004324624",            "modifierGroupName": "Personalización",            "modifierOptionId": "7204558912004327012",            "modifierOptionName": "Bordado",            "value": "Mi tienda",            "quantity": 2,            "priceDelta": 89          }        ],        "metadata": {},        "createdOn": "2026-09-28T15:30:00Z",        "updatedOn": "2026-09-28T15:30:00Z"      }    ],    "shippingMethods": [      {        "id": "7204558912004325350",        "name": "Mi tienda",        "description": "Polo de algodón pima para uso diario.",        "subtotal": 178,        "discountTotal": 178,        "taxTotal": 178,        "total": 178,        "isTaxInclusive": false,        "sellerId": "7204558912004323447",        "shippingProfileId": "7204558912004329819",        "shippingMethodId": "7204558912004325207",        "connectionId": "7204558912004329542",        "providerName": "Courier Lima",        "trackingCode": "PE1234567890",        "estimatedDays": 30,        "zoneCode": "LIMA",        "locationId": "7204558912004328277",        "pickupPointId": "7204558912004324876",        "scheduledDate": "2026-09-28",        "scheduledTime": "09:00:00",        "data": {}      }    ],    "payments": [      {        "id": "7204558912004325350",        "paymentMethod": "Tarjeta de crédito",        "paymentCode": "card",        "amount": 178,        "cardNumber": "Mi tienda",        "cardType": "visa",        "installments": 1,        "authorizationCode": "POL-001",        "transactionReference": "Frente al parque Kennedy.",        "providerId": "7204558912004329705",        "paymentTransactionId": "7204558912004324696",        "paymentStatus": "Mi tienda",        "receiptUrl": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",        "metadata": {},        "refundedAmount": 178,        "refundableAmount": 178      }    ],    "trackings": [      {        "id": "7204558912004325350",        "orderItemId": "7204558912004328121",        "title": "Polo de algodón",        "content": "Gracias por tu compra, Andrea.",        "type": "note",        "userId": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821",        "email": "andrea.ramos@example.com",        "ip": "203.0.113.10",        "createdOn": "2026-09-28T15:30:00Z",        "createdBy": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821"      }    ],    "packageItems": [      {        "id": "7204558912004325350",        "carrierId": "Courier Lima",        "carrierName": "Courier Lima",        "trackingNumber": "PE1234567890",        "trackingLink": "https://tracking.example.com/PE1234567890",        "orderItemId": "7204558912004328121",        "sku": "POL-001-AZ-M",        "packages": 1,        "weight": 0.3,        "quantity": 2,        "serviceType": "Estándar",        "serviceCost": 40,        "from": "ventas@example.com",        "to": "andrea.ramos@example.com",        "partialTracking": true,        "invoiceNumber": "F001-00012345",        "packageType": "delivery",        "packageStatus": "readyToPickUp",        "createdOn": "2026-09-28T15:30:00Z",        "updatedOn": "2026-09-28T15:30:00Z"      }    ],    "transactions": [      {        "id": "7204558912004325350",        "type": "in",        "amount": 178,        "paymentMethod": "Tarjeta de crédito",        "referenceId": "7204558912004328363",        "referenceType": "paymentTransaction",        "transactionReference": "Frente al parque Kennedy.",        "transactionReferenceDocumentLink": "https://mi-tienda.ecomiq.app/products/polo-de-algodon",        "content": "Gracias por tu compra, Andrea.",        "createdOn": "2026-09-28T15:30:00Z",        "createdBy": "2f40d7e4-3d9c-4ab2-b04e-7a6a132db821"      }    ],    "createdOn": "2026-09-28T15:30:00Z",    "updatedOn": "2026-09-28T15:30:00Z",    "financialSummary": {      "paidAmount": 178,      "refundedAmount": 178,      "balanceDue": 1,      "refundableAmount": 178,      "shippingRefundedAmount": 178,      "shippingRefundableAmount": 178,      "refundDue": 1    }  },  "cancellationCompleted": false,  "refundCompleted": false,  "refundErrorCode": "POL-001",  "refundErrorMessage": "Mi tienda"}