</Padrões e Modelos>

Cálculo de frete

Você pode utilizar o serviço de frete do Magalu Marketplace ou utilizar seu próprio serviço de frete. O Cálculo de frete é realizado via uma requisição POST enviada pelo Magazine Luiza para a API do vendedor com objetivo de recuperar informações referente entrega de um produto para uma determinada região.

Códigos de erro

A tabela abaixo contém os erros que podem ser retornados pela API de frete do vendedor e que serão interpretados pelo Magazine Luiza.

HTTP status code	Código	Métodos	Descrição
400	delivery_not_available	POST	Não entrega na região informada
400	invalid_zipcode	POST	CEP inválido
409	out_of_stock	POST	Produto fora de estoque

Requisição para Cálculo de frete

O Magazine Luiza irá enviar uma requisição a API do vendedor solicitando o Cálculo de frete conforme exemplo abaixo:

{
    "session_id": "eb7cd60c-13c7-4247-a2f8-3d7faa4693b5",
    "zipcode": "05036123",
    "items": [
        {
            "sku": "123123123",
            "quantity": 2,
            "price": "10.00",
            "dimensions": {
                "width": "0.570",
                "depth": "0.400",
                "weight": "0.400",
                "height": "0.200"
            }
        }
    ]
}

session_id: ID único da sessão do usuário

dimensions.width, dimensions.depth, dimensions.height: Valores expressos em metros

dimensions.weight: Valor em Quilograma.

Respostas do Cálculo de frete

A API de frete do vendedor deverá retornar a requisição de Cálculo de frete enviada pelo Magazine Luiza conforme os exemplos abaixo.

Atenção: O tipo de entrega, campo type, deve ser definido pelo vendedor para cada transportadora. Também deve ser definida uma única transportadora com tipo convencional conventional, esta transportadora que será utilizada para resposta pelo site Magalu.

type	Descrição
conventional	Entrega Convencional

• Sucesso - Status code 200 (application/json)

    {
        "packages": [
            {
                "items": [
                    {
                        "sku": "123123123",
                        "quantity": 2
                    }
                ],
                "delivery_options": [
                    {
                        "id": "delivery_option_id",
                        "type": "conventional",
                        "name": "Entrega normal",
                        "price": "7.00",
                        "delivery_days": 14
                    }
                ]
            }
        ]
    }
  

• Entrega restrita - Status code 200 (application/json)

    {
        "packages": [
            {
                "items": [
                    {
                        "sku": "123123123",
                        "quantity": 2
                    }
                ],
                "delivery_options": [
                    {
                        "id": "delivery_option_id",
                        "type": "conventional",
                        "name": "Entrega normal",
                        "price": "7.00",
                        "delivery_days": 14,
                        "tags": ["restricted"] 
                    }
                ]
            }
        ]
    }
  

• CEP inválido - Status code 400 (application/json)

    {
        "message": "Invalid zipcode",
        "code": "invalid_zipcode"
    }
  

• Não entrega na região - Status code 400 (application/json)

    {
        "message": "Delivery not available",
        "code": "delivery_not_available",
        "items": [
            {
                "sku": "2342346",
                "available_quantity": 3,
            },
            {
                "sku": "6568345",
                "available_quantity": 1,
            }
        ]
    }
  

• Item fora de estoque - Status code 409 (application/json)

    {
        "message": "Items sem estoque",
        "code": "out_of_stock",
        "items": [
            {
                "sku": "2342346",
                "available_quantity": 3,
            },
            {
                "sku": "6568345",
                "available_quantity": 1,
            }
        ]
    }
  

Para as respostas Não entrega na região e Item fora de estoque o parâmetro available_quantity em items é opcional.