Agora, na API de pedidos, estamos exibindo o GTIN diretamente no retorno dos itens dos pedidos. Com esta novidade, ao realizar uma requisição GET /order ou GET /order/{id}, o campo gtin será retornado dentro de cada item do pedido.
Benefícios para os Integradores:
- Melhor controle e precisão: Ao exibir o GTIN dos itens, fica mais fácil rastrear e gerenciar produtos com base em um código único e padronizado, utilizado globalmente no comércio e em cadeias de suprimentos.
- Facilidade de integração: Com o GTIN disponível diretamente nos itens do pedido, sistemas de terceiros podem identificar produtos de forma mais eficiente, automatizando processos de cadastro e controle de estoque.
- Padronização e consistência: O uso do GTIN facilita a integração com plataformas que dependem desse identificador para sincronizar dados de produtos, como marketplaces e ERPs.
Exemplo de Retorno da API (Quando o GTIN é fornecido):
{
"id": "a18bb1e6-74f8-4463-8358-d5fd4ea704cc",
"postDate": null,
"deliveryDate": null,
"pricePaid": 0,
"status": null,
"processed": false,
"updatedAt": "2022-03-24T14:17:04.000Z",
"quote": {
"id": "6a64cff9-e036-470e-b6f0-5ae8ac7e8812"
},
"method": {
"id": "77cdb830-eb26-40d1-93d6-1c99a6666d2d",
"name": "Á combinar",
"carrierName": "A combinar",
"deliveryTime": 0,
"code": ""
},
"tracking": {
"code": null,
"link": null
},
"items": [
{
"id": "c2108f8e-7eb0-48d6-b834-69b53a541916",
"description": "Teste sem variação",
"productId": "teste_sem_variacao",
"gtin": 7891064603015,
"variationSku": "teste_sem_variacao",
"image": null,
"specifications": null,
"warehouses": [],
"quantity": 1,
"price": 120,
"pricePaid": 120
}
],
"invoices": []
}
Exemplo de Retorno (Quando o GTIN Não Está Disponível):
{
"id": "a18bb1e6-74f8-4463-8358-d5fd4ea704cc",
"postDate": null,
"deliveryDate": null,
"pricePaid": 0,
"status": null,
"processed": false,
"updatedAt": "2022-03-24T14:17:04.000Z",
"quote": {
"id": "6a64cff9-e036-470e-b6f0-5ae8ac7e8812"
},
"method": {
"id": "77cdb830-eb26-40d1-93d6-1c99a6666d2d",
"name": "Á combinar",
"carrierName": "A combinar",
"deliveryTime": 0,
"code": ""
},
"tracking": {
"code": null,
"link": null
},
"items": [
{
"id": "71ab92a2-7bef-42e4-a52d-aaa6b0b7e611",
"description": "Teste variação 1 nível",
"productId": "teste_variacao_nivel_1",
"gtin": null,
"variationSku": "teste_variacao_nivel_1_G",
"image": null,
"specifications": [
{
"value": "G",
"attribute": {
"id": "230d49c3-5a5b-44d0-95a6-865cda570cde",
"label": "Tamanho"
}
}
],
"warehouses": [],
"quantity": 1,
"price": 35,
"pricePaid": 35
}
],
"invoices": []
}
Caso o item não tenha um GTIN cadastrado, o campo retornará null, mantendo a consistência das respostas da API.
Para mais detalhes, consulte a nossa documentação oficial.
Essa melhoria visa facilitar a integração e o gerenciamento de produtos no seu e-commerce.