Cotar pedidos (v1)

Versão antiga da cotação de frete. Prefira a `v2`.

Header obrigatório. Toda chamada exige o header x-abbiamo-seller-group-key. Preencha-o no canto superior direito desta página ou veja como obter a sua chave.

Rate limit: 300 requisições por minuto por chave. Acima disso a API retorna HTTP 429.

Este endpoint serve para your shipping simulations. It was made for simulate shippings with pickup point from one of your stores and and multiples delivery points. So before creating the orders, one can quote how much would they cost and how much time would they take to arrive in the final destination.

The response is divided in two sections:

  • optimized_global_quotation: refers to the best combinations of freights according to the shipping date (fastest) and according to the freight value (cheapest) summing all the available methods

For a method to be selected as the cheapest or the fastest in the response inside the optimized_global_quotation object, it must have both a method_expected_delivery_date and a method_shipping_price.

  • orders: each item of the array corresponds to one quoted order with all the possible quotations for the available methods.

For a method to be shown in the response under quotations inside the orders array, it must have a method_expected_delivery_date.

POST
/v1/quotation/orders
x-abbiamo-seller-group-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

curl -X POST "https://example.com/v1/quotation/orders" \  -H "Content-Type: application/json" \  -d '{    "seller_identifier": "11854583000134",    "orders": [      {        "identifier": "1",        "amount": 100,        "destination_zip_code": "04304011",        "volumes": [          {            "weight": 1570,            "height": 20,            "length": 30,            "width": 10          }        ]      }    ]  }'
"{\n\t\"seller_identifier\": \"31775335000105\",\n\t\"origin_address_zipcode\": \"20521060\",\n\t\"optimized_global_quotation\": {\n\t\t\"fastest\": {\n\t\t\t\"total_orders_shipping_price\": 2000,\n\t\t\t\"max_orders_expected_delivery_date\": \"2023-07-13T15:05:52.236Z\",\n\t\t\t\"orders_quotations\": [\n\t\t\t\t{\n\t\t\t\t\t\"identifier\": \"1\",\n\t\t\t\t\t\"amount\": 100,\n\t\t\t\t\t\"destination_zip_code\": \"04304011\",\n\t\t\t\t\t\"volumes\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"weight\": 1570,\n\t\t\t\t\t\t\t\"height\": 20,\n\t\t\t\t\t\t\t\"length\": 30,\n\t\t\t\t\t\t\t\"width\": 10\n\t\t\t\t\t\t}\n\t\t\t\t\t],\n\t\t\t\t\t\"carrier_name\": \"CARRIER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"5f111deb-dc13-45c7-9821-7f4aa5be856f\",\n\t\t\t\t\t\"method_id\": \"9591bbe7-bbcd-4702-93a4-f340f1dde622\",\n\t\t\t\t\t\"method_type\": \"EXPRESS\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-13T12:05:52.236-03:00\",\n\t\t\t\t\t\"method_shipping_price\": 2000\n\t\t\t\t}\n\t\t\t]\n\t\t},\n\t\t\"cheapest\": {\n\t\t\t\"total_orders_shipping_price\": 1000,\n\t\t\t\"max_orders_expected_delivery_date\": \"2023-07-18T02:59:00.000Z\",\n\t\t\t\"orders_quotations\": [\n\t\t\t\t{\n\t\t\t\t\t\"identifier\": \"1\",\n\t\t\t\t\t\"amount\": 100,\n\t\t\t\t\t\"destination_zip_code\": \"04304011\",\n\t\t\t\t\t\"volumes\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\"weight\": 1570,\n\t\t\t\t\t\t\t\"height\": 20,\n\t\t\t\t\t\t\t\"length\": 30,\n\t\t\t\t\t\t\t\"width\": 10\n\t\t\t\t\t\t}\n\t\t\t\t\t],\n\t\t\t\t\t\"carrier_name\": \"CARRIER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"94928548-bb5a-4474-a639-6018e3b5dae6\",\n\t\t\t\t\t\"method_id\": \"a1fe1560-de68-481f-bdf9-21e19764b171\",\n\t\t\t\t\t\"method_type\": \"D4\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-18T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": 1000\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t},\n\t\"orders\": [\n\t\t{\n\t\t\t\"identifier\": \"1\",\n\t\t\t\"destination_zip_code\": \"04304011\",\n\t\t\t\"volumes\": [\n\t\t\t\t{\n\t\t\t\t\t\"weight\": 1570,\n\t\t\t\t\t\"height\": 20,\n\t\t\t\t\t\"length\": 30,\n\t\t\t\t\t\"width\": 10\n\t\t\t\t}\n\t\t\t],\n\t\t\t\"quotations\": [\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"CARRIER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"94928548-bb5a-4474-a639-6018e3b5dae6\",\n\t\t\t\t\t\"method_id\": \"02ddad13-650c-4fd8-a193-5c0979c7c1c6\",\n\t\t\t\t\t\"method_type\": \"D4\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-18T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": 1000,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": false,\n\t\t\t\t\t\t\"cheapest\": true\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": [\n\t\t\t\t\t\t\"cheapest\"\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"CARRIER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"5f111deb-dc13-45c7-9821-7f4aa5be856f\",\n\t\t\t\t\t\"method_id\": \"8381ff82-0951-4fcd-bf02-8755a386d3e8\",\n\t\t\t\t\t\"method_type\": \"EXPRESS\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-13T12:05:52.236-03:00\",\n\t\t\t\t\t\"method_shipping_price\": 2000,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": true,\n\t\t\t\t\t\t\"cheapest\": false\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": [\n\t\t\t\t\t\t\"fastest\"\n\t\t\t\t\t]\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"SHIPPER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"dc9f1601-9331-4f26-ab34-70136b0d8c40\",\n\t\t\t\t\t\"method_id\": \"ea0dedb6-3fc7-44a0-baf3-cbf8295f2337\",\n\t\t\t\t\t\"method_type\": \"D0\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-14T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": null,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": false,\n\t\t\t\t\t\t\"cheapest\": false\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": []\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"SHIPPER-TEST\",\n\t\t\t\t\t\"logistic_id\": \"a43ad1ab-1e15-464e-80bd-ffdf0c75e534\",\n\t\t\t\t\t\"method_id\": \"7be49a5e-453d-4a55-83c0-21f842b9f207\",\n\t\t\t\t\t\"method_type\": \"D1\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-14T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": null,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": false,\n\t\t\t\t\t\t\"cheapest\": false\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": []\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"GREEN-CARRIER\",\n\t\t\t\t\t\"logistic_id\": \"6a5a1efa-ccf1-442e-aa31-2e2a6d2a46e0\",\n\t\t\t\t\t\"method_id\": \"4f2cc2cf-1ec5-4c3c-9f05-d651654888c1\",\n\t\t\t\t\t\"method_type\": \"D0\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-15T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": null,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": false,\n\t\t\t\t\t\t\"cheapest\": false\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": []\n\t\t\t\t},\n\t\t\t\t{\n\t\t\t\t\t\"carrier_name\": \"GREEN-CARRIER\",\n\t\t\t\t\t\"logistic_id\": \"ed2418ca-9a7d-476e-b6ca-37193f4c5bed\",\n\t\t\t\t\t\"method_id\": \"aa93affd-e1d5-467c-a5c5-e903a0b6aeb6\",\n\t\t\t\t\t\"method_type\": \"D1\",\n\t\t\t\t\t\"method_expected_delivery_date\": \"2023-07-15T02:59:00.000Z\",\n\t\t\t\t\t\"method_shipping_price\": null,\n\t\t\t\t\t\"tags_object\": {\n\t\t\t\t\t\t\"fastest\": false,\n\t\t\t\t\t\t\"cheapest\": false\n\t\t\t\t\t},\n\t\t\t\t\t\"tags\": []\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}"
"{}"