{"section":"announcements","requestedLocale":"en","requestedSlug":"2019-04-10-new-object-returned-to-api-get-order-cancelreason","locale":"en","slug":"2019-04-10-new-object-returned-to-api-get-order-cancelreason","path":"docs/en/announcements/2019/april/2019-04-10-new-object-returned-to-api-get-order-cancelreason.md","branch":"main","content":"As of May 10, 2019, JSON orders will return a new object called cancelReason.\nThis object will return the reason filled by the user for the cancellation of an order. \n\nExample of JSON with \"cancel Reason\":\n```  \"orderId\": \"922480366938-01\",\n    \"sequence\": \"500367\",\n    \"marketplaceOrderId\": \"\",\n    \"marketplaceServicesEndpoint\": \"http://oms.vtexinternal.com.br/api/oms?an=partnerslatam\",\n    \"sellerOrderId\": \"00-922480366938-01\",\n    \"origin\": \"Marketplace\",\n    \"affiliateId\": \"\",\n    \"salesChannel\": \"1\",\n    \"merchantName\": null,\n    \"status\": \"canceled\",\n    \"statusDescription\": \"Cancelado\",\n    \"value\": 11000000,\n    \"creationDate\": \"2019-04-04T16:06:37.4898827+00:00\",\n    \"lastChange\": \"2019-04-04T16:08:51.0329191+00:00\",\n    \"orderGroup\": \"922480366938\",\n    \"totals\": [ ],\n    \"items\": [ ],\n    \"marketplaceItems\": [ ],\n    \"clientProfileData\": { },\n    \"giftRegistryData\": null,\n    \"marketingData\": null,\n    \"ratesAndBenefitsData\": { },\n    \"shippingData\": { },\n    \"paymentData\": { },\n    \"packageAttachment\": { },\n    \"sellers\": [ ],\n    \"callCenterOperatorData\": null,\n    \"followUpEmail\": \"30715524e1464d1fb9d43a0e303fa332@ct.vtex.com.br\",\n    \"lastMessage\": null,\n    \"hostname\": \"partnerslatam\",\n    \"invoiceData\": null,\n    \"changesAttachment\": null,\n    \"openTextField\": null,\n    \"roundingError\": 0,\n    \"orderFormId\": \"fd5936d662e94b9cafb63a1ff8d92dd3\",\n    \"commercialConditionData\": null,\n    \"isCompleted\": true,\n    \"customData\": null,\n    \"storePreferencesData\": { },\n    \"allowCancellation\": false,\n    \"allowEdition\": false,\n    \"isCheckedIn\": false,\n    \"marketplace\": {},\n    \"authorizedDate\": null,\n    \"invoicedDate\": null,\n    \"itemMetadata\": {},\n    \"cancelReason\": \"The customer bought the wrong product size\"\n```\n* \"cancelReason\": \"The customer bought the wrong product size\"  \n\nThe field value corresponds to the information filled in at the moment of cancellation of the order.\n\n## Main Advantages\nThe new field allows the ERP system to consume the information that was entered as justification for canceling an order. This field will soon be available in the report issued by the Order Management module.\n\n## What you need to do\nIt is imperative to review the integrations that use the Get Order APIs, such as ERP, for example. Those who are not prepared to receive the new answer need to be adjusted before April 30th, 2019.\n\nTo test this, you can use the beta route:\nhttps://\\{\\{accountName\\}\\}.vtexcommercebeta.com.br/api/oms/pvt/orders/\\{\\{orderId\\}\\}"}