The following Olist resources are available:
When a single or massive problem is identified, impacting customers in a production environment, an email must be sent here containing all information and evidence of the case in question.
Remembering that the email must always be opened by the team responsible for the integration and not by the seller.
Notifications mechanism:
The base URL for production Olist API: https://partners-api.olist.com/v1
The base URL for our sandbox environment: https://partners-sandbox-api.olist.com/v1
We have two different applications that works together in our environment, the auth app and the partners app. They have different base urls. Below we show the base url for each environment.
SANDBOX
Authentication's Base URL: https://auth-engine.olist.com/realms/3rd-party-sandbox
API's Base URL: https://partners-sandbox-api.olist.com/v1
PRODUCTION
Authentication's Base URL: https://id.olist.com/
API's Base URL: https://partners-api.olist.com/v1
We've created a Postman collection containing all requests available in the sandbox.
{
"info": {
"_postman_id": "9ac70404-d9f5-4a15-b689-0f9df04cb722",
"name": "[Sandbox] Partners API",
"schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
"_exporter_id": "3054702"
},
"item": [
{
"name": "partners",
"item": [
{
"name": "create",
"request": {
"auth": {
"type": "noauth"
},
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"Sandbox Test\",\n \"client_id\": \"sandbox_test\",\n \"password\": \"123456\",\n \"redirect_uris\": [\n \"http://localhost:8001/event\"\n ],\n \"notification_webhook\": \"http://localhost:8001/event\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/partners/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"partners",
""
]
}
},
"response": []
},
{
"name": "reset",
"request": {
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n \"name\": \"Developers\",\n \"client_id\": \"developers\",\n \"password\": \"123456\",\n \"redirect_uris\": [\n \"http://localhost:8001/event\"\n ],\n \"notification_webhook\": \"http://localhost:8001/event\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/partners/reset/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"partners",
"reset",
""
]
}
},
"response": []
},
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3Mjk2MzQ3MDIsImlhdCI6MTcyOTU0ODMwMiwiYXV0aF90aW1lIjoxNzI5NTQzOTk4LCJqdGkiOiI2MmFjZjBkYi0xNjc2LTQ4Y2QtYjk2OC0zODVhNjA0NDUzNzUiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImF0X2hhc2giOiJnZW5Pbi1Nb0RlQ0xYTWtVWHlNZHhnIiwiYWNyIjoiMCIsInNpZCI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.U8kBdOlvASA-4ctg5_1KgYEh1J_M2FXhrODMaCvnziBRGJmCFCqVxVOVfbajtZbQtVVw4GsVMtPf_Mt6pPPf4TBVqInwhIeHFM9jGkf2aqB9Y1W5Wb5QxKxagJp-eq8wARXDHJjBGD-g8g0WBK_qHFsKTc5dtSsvZblNvDmEvpyH5fwPOqNc1DTshiBpQKG9QelbtzqY3ZYFictcPM4Avg_OhIWNQGJkf1tWU12Lk_sbsVC9E3qbCcRjRn0K5bDNBNtfdz4uCexyO66BiaRcKKgteMXww0jmfZZgAoIeu2nQyKbUrES7iTzSmgN3GsXcPNNHnubkMyxBF-v24vn7uA",
"type": "text",
"disabled": true
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text",
"disabled": true
},
{
"key": "User-Agent",
"value": "postman",
"type": "text",
"disabled": true
}
],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/partners/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"partners",
""
]
}
},
"response": []
}
]
},
{
"name": "homologation",
"item": [
{
"name": "create",
"request": {
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n \"items\": [\"Product\", \"Order\"]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/homologation/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"homologation",
""
]
}
},
"response": []
},
{
"name": "list",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3Mjk2MzQ3MDIsImlhdCI6MTcyOTU0ODMwMiwiYXV0aF90aW1lIjoxNzI5NTQzOTk4LCJqdGkiOiI2MmFjZjBkYi0xNjc2LTQ4Y2QtYjk2OC0zODVhNjA0NDUzNzUiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImF0X2hhc2giOiJnZW5Pbi1Nb0RlQ0xYTWtVWHlNZHhnIiwiYWNyIjoiMCIsInNpZCI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.U8kBdOlvASA-4ctg5_1KgYEh1J_M2FXhrODMaCvnziBRGJmCFCqVxVOVfbajtZbQtVVw4GsVMtPf_Mt6pPPf4TBVqInwhIeHFM9jGkf2aqB9Y1W5Wb5QxKxagJp-eq8wARXDHJjBGD-g8g0WBK_qHFsKTc5dtSsvZblNvDmEvpyH5fwPOqNc1DTshiBpQKG9QelbtzqY3ZYFictcPM4Avg_OhIWNQGJkf1tWU12Lk_sbsVC9E3qbCcRjRn0K5bDNBNtfdz4uCexyO66BiaRcKKgteMXww0jmfZZgAoIeu2nQyKbUrES7iTzSmgN3GsXcPNNHnubkMyxBF-v24vn7uA",
"type": "text",
"disabled": true
},
{
"key": "Content-Type",
"value": "application/json",
"type": "text",
"disabled": true
},
{
"key": "User-Agent",
"value": "postman",
"type": "text",
"disabled": true
}
],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/homologation/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"homologation",
""
]
}
},
"response": []
}
]
},
{
"name": "sellers",
"item": [
{
"name": "{id}",
"item": [
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/sellers/dfb888d6-6a5d-4c0e-b7e3-546f0f74a3fb/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"sellers",
"dfb888d6-6a5d-4c0e-b7e3-546f0f74a3fb",
""
]
}
},
"response": []
}
]
},
{
"name": "list",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/sellers/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"sellers",
""
]
}
},
"response": []
}
]
},
{
"name": "seller-products",
"item": [
{
"name": "{id}",
"item": [
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3Mjk2MzQ3MDIsImlhdCI6MTcyOTU0ODMwMiwiYXV0aF90aW1lIjoxNzI5NTQzOTk4LCJqdGkiOiI2MmFjZjBkYi0xNjc2LTQ4Y2QtYjk2OC0zODVhNjA0NDUzNzUiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImF0X2hhc2giOiJnZW5Pbi1Nb0RlQ0xYTWtVWHlNZHhnIiwiYWNyIjoiMCIsInNpZCI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.U8kBdOlvASA-4ctg5_1KgYEh1J_M2FXhrODMaCvnziBRGJmCFCqVxVOVfbajtZbQtVVw4GsVMtPf_Mt6pPPf4TBVqInwhIeHFM9jGkf2aqB9Y1W5Wb5QxKxagJp-eq8wARXDHJjBGD-g8g0WBK_qHFsKTc5dtSsvZblNvDmEvpyH5fwPOqNc1DTshiBpQKG9QelbtzqY3ZYFictcPM4Avg_OhIWNQGJkf1tWU12Lk_sbsVC9E3qbCcRjRn0K5bDNBNtfdz4uCexyO66BiaRcKKgteMXww0jmfZZgAoIeu2nQyKbUrES7iTzSmgN3GsXcPNNHnubkMyxBF-v24vn7uA",
"type": "text"
}
],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-products/PRDJ8A5CP01747AD/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-products",
"PRDJ8A5CP01747AD",
""
]
}
},
"response": []
},
{
"name": "partial update",
"request": {
"method": "PATCH",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3Mjk2MzQ3MDIsImlhdCI6MTcyOTU0ODMwMiwiYXV0aF90aW1lIjoxNzI5NTQzOTk4LCJqdGkiOiI2MmFjZjBkYi0xNjc2LTQ4Y2QtYjk2OC0zODVhNjA0NDUzNzUiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImF0X2hhc2giOiJnZW5Pbi1Nb0RlQ0xYTWtVWHlNZHhnIiwiYWNyIjoiMCIsInNpZCI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.U8kBdOlvASA-4ctg5_1KgYEh1J_M2FXhrODMaCvnziBRGJmCFCqVxVOVfbajtZbQtVVw4GsVMtPf_Mt6pPPf4TBVqInwhIeHFM9jGkf2aqB9Y1W5Wb5QxKxagJp-eq8wARXDHJjBGD-g8g0WBK_qHFsKTc5dtSsvZblNvDmEvpyH5fwPOqNc1DTshiBpQKG9QelbtzqY3ZYFictcPM4Avg_OhIWNQGJkf1tWU12Lk_sbsVC9E3qbCcRjRn0K5bDNBNtfdz4uCexyO66BiaRcKKgteMXww0jmfZZgAoIeu2nQyKbUrES7iTzSmgN3GsXcPNNHnubkMyxBF-v24vn7uA",
"type": "text"
}
],
"body": {
"mode": "raw",
"raw": "{\n \"gtin\": \"21700719670850\",\n \"prices\": [\n {\n \"channel_slug\": \"mercadolivre\",\n \"currency\": \"BRL\",\n \"minimum_quantity\": 1,\n \"offer\": \"290.00\",\n \"value\": \"300.00\",\n \"price_freight_shift\": \"0.00\"\n }\n ],\n \"name\": \"Camisa Polo Muito Linda Mesmo\",\n \"attributes\": [\n {\n \"attribute_name\": \"Cor\",\n \"attribute_value\": \"Verde\",\n \"category_attribute_id\": null\n },\n {\n \"attribute_name\": \"Tamanho\",\n \"attribute_value\": \"G\",\n \"category_attribute_id\": null\n }\n ],\n \"description\": \"Camisa Polo Muito Linda Mesmo\\n\\nCor: Verde\\nTamanho: G\\n\\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Ut dui enim, aliquam eu sagittis a, accumsan ac lectus. Pellentesque at facilisis odio. Nulla sollicitudin volutpat metus et pharetra. Nullam non velit aliquam, tempus mi et, posuere sem. Sed nec nisi nec nibh vulputate tincidunt. Duis facilisis ipsum vel vulputate tincidunt. Vestibulum sit amet posuere nisi, eget rutrum nunc. Morbi eu nisi tristique, accumsan leo eu, accumsan enim. Pellentesque quis libero risus. Nullam enim nisl, ultrices sit amet volutpat quis, tempor in ipsum. Nullam sodales congue diam. Cras accumsan libero sed eros facilisis, vitae aliquet turpis vestibulum. Praesent tortor ipsum, gravida sed mollis a, sollicitudin ac mauris. Proin laoreet bibendum lacus. Nunc a imperdiet felis. Morbi in orci sapien.\",\n \n \"availability_days\": 0,\n \"brand\": \"Novo Século\",\n \"categories\": [],\n \n \"free_shipping\": false,\n \n \n \"origin\": \"developers\",\n \"package_measures\": [\n {\n \"height_unit\": \"cm\",\n \"height_value\": \"50.0000\",\n \"length_unit\": \"cm\",\n \"length_value\": \"90.0000\",\n \"weight_unit\": \"g\",\n \"weight_value\": \"2000.00\",\n \"width_unit\": \"cm\",\n \"width_value\": \"20.0000\",\n \"capacity\": 1\n }\n ],\n \"photos\": [\n {\n \"order\": 0,\n \"url\": \"https://olist-v2-dev.s3.amazonaws.com/products-images/85c8e282-1f1a-4bda-a7cc-7b55553bfc94.jpg\"\n },\n {\n \"order\": 1,\n \"url\": \"https://olist-v2-dev.s3.amazonaws.com/products-images/c44563a73974485a-99cf-d58f9d67e599.jpg\"\n }\n ],\n \n \"in_campaign\": false,\n \"product_code\": \"54321\",\n \"product_measures\": [\n {\n \"height_unit\": \"cm\",\n \"height_value\": \"2.0000\",\n \"length_unit\": \"cm\",\n \"length_value\": \"23.0000\",\n \"weight_unit\": \"g\",\n \"weight_value\": \"358.0000\",\n \"width_unit\": \"cm\",\n \"width_value\": \"16.0000\"\n }\n ],\n \"seller_id\": \"dfb888d6-6a5d-4c0e-b7e3-546f0f74a3fb\",\n \"stock\": [\n {\n \"availability_days\": 0,\n \"quantity\": 5\n }\n ],\n \"tags\": []\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-products/PRDJ8A5CP01747AD/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-products",
"PRDJ8A5CP01747AD",
""
]
}
},
"response": []
}
]
},
{
"name": "list",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-products/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-products",
""
]
}
},
"response": []
},
{
"name": "create",
"request": {
"method": "POST",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3MzAyNTQ3NjksImlhdCI6MTczMDE2ODM2OSwiYXV0aF90aW1lIjoxNzMwMTY4MzU5LCJqdGkiOiI0YWYwMjYxYy0wY2ZmLTRjYTAtOGU1ZC1iMGIyNTEzMDFiNDQiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjMyODRlNzY2LTU0ZGItNDg5MS05YWUyLWZhY2ZmZjliOWNkZCIsImF0X2hhc2giOiJoTTBGaGRUQ0l0V0xwOUY4NkxJeFdRIiwiYWNyIjoiMSIsInNpZCI6IjMyODRlNzY2LTU0ZGItNDg5MS05YWUyLWZhY2ZmZjliOWNkZCIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.azaYUNQ9VaLZwQcGiB2Y7l17s6G-q2dI_-SoWGdmh9PEIPReT5CmpTz6amf_h9fdjfaly1PU7HuOo0mOz5Ze32pgQdhQUZJscX4osfEKNTALYV-Dofp_OgPTis_JU9IodV-OHEl4HQmb2f0jji9hhJyD_aU34TNaS61jZv5uWykSOaNA5mxUMbbgFd7Zgrr_Ipu14Lx-urYOr0Tu2_-QANRvKujjeYF3QuC8Irss1XdLee3qpNpXHE6J564ZGQwfN6hzqOgRioGaGvyn9gU1HUfv6zpmJ5tHee1Du9oSh8wMn_0W0szIorKIK100OWBlV7C6t6BItEVlTY4-X6VurA",
"type": "text",
"disabled": true
}
],
"body": {
"mode": "raw",
"raw": "{\n \"gtin\": \"21700719670850\",\n \"prices\": [\n {\n \"channel_slug\": \"mercadolivre\",\n \"currency\": \"BRL\",\n \"minimum_quantity\": 1,\n \"offer\": \"290.00\",\n \"value\": \"300.00\",\n \"price_freight_shift\": \"0.00\"\n }\n ],\n \"name\": \"Camisa Polo Muito Linda Mesmo\",\n \"attributes\": [\n {\n \"attribute_name\": \"Cor\",\n \"attribute_value\": \"Verde\",\n \"category_attribute_id\": null\n },\n {\n \"attribute_name\": \"Tamanho\",\n \"attribute_value\": \"G\",\n \"category_attribute_id\": null\n }\n ],\n \"description\": \"Camisa Polo Muito Linda Mesmo\\n\\nCor: Verde\\nTamanho: G\\n\\nLorem ipsum dolor sit amet, consectetur adipiscing elit. Ut dui enim, aliquam eu sagittis a, accumsan ac lectus. Pellentesque at facilisis odio. Nulla sollicitudin volutpat metus et pharetra. Nullam non velit aliquam, tempus mi et, posuere sem. Sed nec nisi nec nibh vulputate tincidunt. Duis facilisis ipsum vel vulputate tincidunt. Vestibulum sit amet posuere nisi, eget rutrum nunc. Morbi eu nisi tristique, accumsan leo eu, accumsan enim. Pellentesque quis libero risus. Nullam enim nisl, ultrices sit amet volutpat quis, tempor in ipsum. Nullam sodales congue diam. Cras accumsan libero sed eros facilisis, vitae aliquet turpis vestibulum. Praesent tortor ipsum, gravida sed mollis a, sollicitudin ac mauris. Proin laoreet bibendum lacus. Nunc a imperdiet felis. Morbi in orci sapien.\",\n \n \"availability_days\": 0,\n \"brand\": \"Novo Século\",\n \"categories\": [],\n \n \"free_shipping\": false,\n \n \n \"origin\": \"developers\",\n \"package_measures\": [\n {\n \"height_unit\": \"cm\",\n \"height_value\": \"50.0000\",\n \"length_unit\": \"cm\",\n \"length_value\": \"90.0000\",\n \"weight_unit\": \"g\",\n \"weight_value\": \"2000.00\",\n \"width_unit\": \"cm\",\n \"width_value\": \"20.0000\",\n \"capacity\": 1\n }\n ],\n \"photos\": [\n {\n \"order\": 0,\n \"url\": \"https://olist-v2-dev.s3.amazonaws.com/products-images/85c8e282-1f1a-4bda-a7cc-7b55553bfc94.jpg\"\n },\n {\n \"order\": 1,\n \"url\": \"https://olist-v2-dev.s3.amazonaws.com/products-images/c44563a73974485a-99cf-d58f9d67e599.jpg\"\n }\n ],\n \n \"in_campaign\": false,\n \"product_code\": \"54321\",\n \"product_measures\": [\n {\n \"height_unit\": \"cm\",\n \"height_value\": \"2.0000\",\n \"length_unit\": \"cm\",\n \"length_value\": \"23.0000\",\n \"weight_unit\": \"g\",\n \"weight_value\": \"358.0000\",\n \"width_unit\": \"cm\",\n \"width_value\": \"16.0000\"\n }\n ],\n \"seller_id\": \"dfb888d6-6a5d-4c0e-b7e3-546f0f74a3fb\",\n \"stock\": [\n {\n \"availability_days\": 0,\n \"quantity\": 5\n }\n ],\n \"tags\": []\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-products/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-products",
""
]
}
},
"response": []
}
]
},
{
"name": "seller-orders",
"item": [
{
"name": "{code}",
"item": [
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [
{
"key": "Authorization",
"value": "JWT eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJZel90TVpiXzdOd2NMZVVaT0tYc2NRdW8wUE4zN0JvYkNONjhFdE80WVFzIn0.eyJleHAiOjE3Mjk2MzQ3MDIsImlhdCI6MTcyOTU0ODMwMiwiYXV0aF90aW1lIjoxNzI5NTQzOTk4LCJqdGkiOiI2MmFjZjBkYi0xNjc2LTQ4Y2QtYjk2OC0zODVhNjA0NDUzNzUiLCJpc3MiOiJodHRwczovL2F1dGgtZW5naW5lLm9saXN0LmNvbS9yZWFsbXMvM3JkLXBhcnR5LXNhbmRib3giLCJhdWQiOiJmYWtlXzk5Iiwic3ViIjoiNGUxY2JjOGQtYmViZC00ZGJlLThmNjYtZWZhZGJjNjM0NDBkIiwidHlwIjoiSUQiLCJhenAiOiJmYWtlXzk5Iiwic2Vzc2lvbl9zdGF0ZSI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImF0X2hhc2giOiJnZW5Pbi1Nb0RlQ0xYTWtVWHlNZHhnIiwiYWNyIjoiMCIsInNpZCI6IjgxZTAyYzUxLTEzOWEtNDA0MS04ZThjLWU5MDM3ZTQ3NDZlNiIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJmYWtlIDk5IiwiZW1haWwiOiJmYWtlXzk5QHBhcnRuZXJzLXNhbmRib3gtYXBpLm9saXN0LmNvbSJ9.U8kBdOlvASA-4ctg5_1KgYEh1J_M2FXhrODMaCvnziBRGJmCFCqVxVOVfbajtZbQtVVw4GsVMtPf_Mt6pPPf4TBVqInwhIeHFM9jGkf2aqB9Y1W5Wb5QxKxagJp-eq8wARXDHJjBGD-g8g0WBK_qHFsKTc5dtSsvZblNvDmEvpyH5fwPOqNc1DTshiBpQKG9QelbtzqY3ZYFictcPM4Avg_OhIWNQGJkf1tWU12Lk_sbsVC9E3qbCcRjRn0K5bDNBNtfdz4uCexyO66BiaRcKKgteMXww0jmfZZgAoIeu2nQyKbUrES7iTzSmgN3GsXcPNNHnubkMyxBF-v24vn7uA",
"type": "text"
}
],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-orders/ORDPFXB3B9QN8IQ7/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-orders",
"ORDPFXB3B9QN8IQ7",
""
]
}
},
"response": []
},
{
"name": "send-invoice",
"request": {
"method": "PUT",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n\t\"url\": \"http://example.com/invoices/invoice.xml\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-orders/ORDPFXB3B9QN8IQ7/invoice/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-orders",
"ORDPFXB3B9QN8IQ7",
"invoice",
""
]
}
},
"response": []
}
]
},
{
"name": "list",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/seller-orders/?status=approved",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"seller-orders",
""
],
"query": [
{
"key": "status",
"value": "approved"
}
]
}
},
"response": []
}
]
},
{
"name": "packages",
"item": [
{
"name": "{id}",
"item": [
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/packages/10e0f9a3-7bb3-4f51-8b26-c65888e0a5b6/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"packages",
"10e0f9a3-7bb3-4f51-8b26-c65888e0a5b6",
""
]
}
},
"response": []
}
]
},
{
"name": "list",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/packages/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"packages",
""
]
}
},
"response": []
},
{
"name": "build-zpl",
"request": {
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n \"packages\": [\"10e0f9a3-7bb3-4f51-8b26-c65888e0a5b6\", \"0d569eb3-3574-40e9-818b-b3e62a0d1fc1\"]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/packages/build-zpl/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"packages",
"build-zpl",
""
]
}
},
"response": []
}
]
},
{
"name": "shipments",
"item": [
{
"name": "list",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/shipments/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"shipments",
""
]
}
},
"response": []
},
{
"name": "create",
"request": {
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n \"seller\": \"dfb888d6-6a5d-4c0e-b7e3-546f0f74a3fb\",\n \"packages\": [\"10e0f9a3-7bb3-4f51-8b26-c65888e0a5b6\", \"0d569eb3-3574-40e9-818b-b3e62a0d1fc1\"]\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/shipments/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"shipments",
""
]
}
},
"response": []
}
]
},
{
"name": "transaction-report",
"item": [
{
"name": "{id}",
"item": [
{
"name": "retrieve",
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/transaction-reports/24025cad-bcf8-4c8e-b58c-37629a107787/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"transaction-reports",
"24025cad-bcf8-4c8e-b58c-37629a107787",
""
]
}
},
"response": []
}
]
},
{
"name": "create",
"request": {
"method": "POST",
"header": [],
"body": {
"mode": "raw",
"raw": "{\n\t\"reference_year\": \"2025\",\n\t\"reference_month\": \"1\",\n\t\"language\": \"pt-br\"\n}",
"options": {
"raw": {
"language": "json"
}
}
},
"url": {
"raw": "{{PARTNERS_SANDBOX_API_URL}}/transaction-reports/",
"host": [
"{{PARTNERS_SANDBOX_API_URL}}"
],
"path": [
"transaction-reports",
""
]
}
},
"response": []
}
]
},
{
"name": "Authentication",
"item": [
{
"name": "Oauth",
"event": [
{
"listen": "test",
"script": {
"exec": [
""
],
"type": "text/javascript",
"packages": {}
}
}
],
"request": {
"method": "GET",
"header": [],
"url": {
"raw": "https://auth-engine.olist.com/realms/3rd-party-sandbox/protocol/openid-connect/auth?client_id=developers&email=developers@partners-sandbox-api.olist.com&response_type=code&redirect_uri=http://localhost:8001/event&scope=openid%20email%20profile&state=TOPSECRET123",
"protocol": "https",
"host": [
"auth-engine",
"olist",
"com"
],
"path": [
"realms",
"3rd-party-sandbox",
"protocol",
"openid-connect",
"auth"
],
"query": [
{
"key": "client_id",
"value": "developers"
},
{
"key": "email",
"value": "developers@partners-sandbox-api.olist.com"
},
{
"key": "response_type",
"value": "code"
},
{
"key": "redirect_uri",
"value": "http://localhost:8001/event"
},
{
"key": "scope",
"value": "openid%20email%20profile"
},
{
"key": "state",
"value": "TOPSECRET123"
}
]
}
},
"response": []
},
{
"name": "JWT Token",
"event": [
{
"listen": "test",
"script": {
"exec": [
"var jsonData = JSON.parse(responseBody);",
"postman.collectionVariables.set(\"API_TOKEN\", \"JWT \" + jsonData.id_token);"
],
"type": "text/javascript",
"packages": {}
}
}
],
"request": {
"method": "POST",
"header": [
{
"key": "Content-Type",
"value": "application/x-www-form-urlencoded",
"type": "text"
}
],
"body": {
"mode": "urlencoded",
"urlencoded": [
{
"key": "code",
"value": "0ec4918c-d2a9-4551-a0ad-9e1a686c8b08.73c28705-9985-45d4-aeb6-e80f92aa44bf.ea01e8b5-e913-45dc-84e3-14e16786a1c2",
"type": "text"
},
{
"key": "client_id",
"value": "developers",
"type": "text"
},
{
"key": "client_secret",
"value": "ne3FWWZRXCitN3IoJHtUSbuyk8N9nRZB",
"type": "text"
},
{
"key": "redirect_uri",
"value": "http://localhost:8001/event",
"type": "text"
},
{
"key": "grant_type",
"value": "authorization_code",
"type": "text"
}
]
},
"url": {
"raw": "https://auth-engine.olist.com/realms/3rd-party-sandbox/protocol/openid-connect/token",
"protocol": "https",
"host": [
"auth-engine",
"olist",
"com"
],
"path": [
"realms",
"3rd-party-sandbox",
"protocol",
"openid-connect",
"token"
]
}
},
"response": []
}
]
},
{
"name": "Ping",
"request": {
"auth": {
"type": "noauth"
},
"method": "GET",
"header": [],
"url": {
"raw": "https://app-be16b15f-9bf2-4a20-8a25-360c0fd672b0.ops.olist.io/ping/",
"protocol": "https",
"host": [
"app-be16b15f-9bf2-4a20-8a25-360c0fd672b0",
"ops",
"olist",
"io"
],
"path": [
"ping",
""
]
}
},
"response": []
}
],
"auth": {
"type": "apikey",
"apikey": [
{
"key": "value",
"value": "{{PARTNERS_SANDBOX_API_TOKEN}}",
"type": "string"
},
{
"key": "key",
"value": "Authorization",
"type": "string"
}
]
},
"event": [
{
"listen": "prerequest",
"script": {
"type": "text/javascript",
"packages": {},
"exec": [
""
]
}
},
{
"listen": "test",
"script": {
"type": "text/javascript",
"packages": {},
"exec": [
""
]
}
}
],
"variable": [
{
"key": "PARTNERS_SANDBOX_API_URL",
"value": "https://partners-sandbox-api.olist.com/v1",
"type": "string"
},
{
"key": "PARTNERS_SANDBOX_API_TOKEN",
"value": "",
"type": "string"
}
]
}After completing the development of your application, go to the Homologation section and follow the instructions there.
What's Next
Notification Mechanism