- O token será enviado no header da requisição.

Header : { token : xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx }

- Se o token estiver errado mostrará uma mensagem de falha e não será possível realizar a cotação solicitada.

3.Observação dos campos

- Analisar as informações que vão receber os valores conforme os campos que encontram no item 4 (Estrutura do Json).

- Verificar se os campos estão corretos, pois caso esteja errado, o sistema não permitirá salvar as informações que contém o erro.

4.Estrutura do Json de Request

Segue a estrutura do json com os campos necessários para registrar as informações no banco de dados:

{
"destination": "13295000",
"items": [
{
"seller_id": "89540000",
"sku": "prod-1",
"quantity": 1,
"origin":" 02611-000",
"price": 316,
"dimensions": {
"length": 1,
"height": 1,
"width": 1,
"weight": 1
}
} ,
{
"seller_id": "89540000",
"sku": " prod-2",
"quantity": 1,
"origin":" 02611-000",
"price": 316,
"dimensions": {
"length": 1,
"height": 1,
"width": 1,
"weight": 1
}
}

]
}

5.Estrutura de json de resposta

A resposta​ deve retornar as cotações para os itens comprados, separados por “pacotes”. Devem existir no máximo 2 (duas) cotações por pacote, tendo como ​caption​​ os nomes Normal​​ ou ​Expresso​​ e todos os valores da resposta são obrigatórios​​.

• packages (array)​​: É a lista de pacotes criados pelo lojista.
• items (array)​​: É a lista de itens dentro de um mesmo pacote.

• Error_code: -1: Erro inesperado (utilizar somente em casos muito específicos).
• Error_code: 0: Sem Erro.
• Error_code: 1: Quantidade não disponível em estoque.
• Error_code: 2: CEP de destino inválido
• Error_code: 3: Produto não disponível para o CEP de destino.
• Error_code: 4: Produto escolhido não existe.

• quotations (array)​​: É a lista de cotação de frete para um pacote.

- Segue o exemplo da estrutura do json que será respondido:

{
"packages": [
{
"items": [
{
"sku": "00266983118",
"seller_id": "207740981",
"quantity": 1,
"stock": -1,
"error_code": 0,
"store_id": null
}
],
"quotations": [
{
"cost": 66.6,
"price": 66.6,
"handling_time": 0,
"shipping_time": 39,
"promise": 39,
"caption": "Normal"
}
]
}
]
}

1. Conexão SISFRETE

2. Enviando dados da cotação

2.1 Existem duas formas de declarar o destino da cotação:

3. Enviando dados dos produtos

4. Interpretando a resposta

O resultado da cotação é devolvido em XML. A tag contém os dados de cada resultado obtido para a cotação realizada. Dentro desta tag temos:

<cotacao>

</resultado>

<resultado>

</resultado>


</cotacao>

5. Identificando erros

<cotacao>

</cotacao>

PRODUTOS

Post/API/produto Criar um produto

Insere um PRODUTO no banco MongoDB

Altura, Largura e Comprimento sendo enviados em centímetros. Peso enviado em quilo.

Request URL: https://api3.sisfrete.com.br/api/produto curl :

Campos do json do produto

{

altura* number ($double)

Altura em centímetros

codigoFamilia* string

Codigo da família do Produto

codigoProduto string

Código do produto

componentesKit* string

json do ComponentesKit (KPL):

[{"codigoProdutoComponente":"7287","quantidade":1.0},

{"codigoProdutoComponente":"7289","quantidade":1.0}]

comprimento* number($double)

Comprimento em centímetros

descrição string

Descrição do produto

largura* number ($double)

Largura em centímetros

origemMercadoria* string

Origem da mercadoria

peso* number($double) Peso em Quilo

}

Exemplo json:

PEDIDOS

POST/api/order Criar pedido(s)

Insere um PEDIDO no banco WEBTRACKING na tabela AVAILABLE_ORDER.

O pedido passa por validações de informações de Transportadora, Canal e Subcanal para realizar as cotações para o pedido virar um Objeto.

Produtos dentro do pedido devem ser enviados em METRO e QUILO

Request URL:

https://api3.sisfrete.com.br/api/order

curl :

Campos do json do pedido

caixas [{

Altura number ($double)

example: 1.5

Altura do produto em ponto flutuante(metro)

Código string

Código do produto

Comprimento number ($double)

example: 1.5
Comprimento do produto em ponto flutuante (metro)

Valor do produto

}]

canalVenda string

example: OmniOne

Canal de venda

chaveNfe string

Número da Danfe

codigoPedidoAbacos* string

código Pedido Abacos

codigoServico string

Código do serviço

codigoTransportadora string

Código da transportadora

dataEmissaoNota string($date-time)

example: 2022-00-00T00:00

Número de serie da nota fiscal

dataVenda string($date)

example: 2022-00-00

Data da venda

destinatarioBairro string

Bairro do destinatário

destinatarioCelular string

Número celular do destinatário

destinatarioCep string

Código do destinatário

destinatarioCidade string

Cidade do destinatário

destinatarioCpfCnpj string

Documento do destinatário

destinatarioEmail string

Email do destinatário

destinatarioEstado string

Estado do destinatário

destinatarioNome string

Nome do destinatário

destinatarioNumero string

Número do destinatário

destinatarioPais string

Pais do destinatário

destinatarioRua string

Rua do destinatário

destinatarioTipo string

example: F

Código do destinatário

numeroDoPedido* string

Número do pedido

numeroNota integer($int32)

Número da nota fiscal

numeroObjeto string

Número do rastreio

pedidoCanalVenda string

example: 9999999999999999-9

Código do pedido no canal de venda

produtos [{

altura number($double)

example: 1.5

Altura do produto em ponto flutuante(metro)

código string

Código do produto

comprimento number($double)

example: 1.5

Comprimento do produto em ponto flutuante(metro)

cubicoComFator number($double)

Valor do produto

cubicoIndividual number($double)

Valor do produto

largura number($double)

example: 1.5

Largura do produto em ponto flutuante(metro)

peso number($double)

Peso do produto(quilo)

quantidade number($double)

Quantidade do produto

valor number($double)

Valor do produto

}]

serieNota string

Número de serie da nota fiscal

servicoEntrega string

Número do serviço de entrega

statusPedido* string

Status do pedido

subCanal string

example: Mercado Livre

Número do subcanal (marketplace)

transportadoraNome string

example: Rodonaves

Nome da transportadora

valorFrete number($double)

example: 10.2

Valor do frete

valorPedido number($double)

example: 10.2

Valor do pedido

}

Exemplo json:

EMBALAMENTO

POST/api/embalamento Criar embalamento

Envia o EMBALAMENTO no banco WEBTRACKING na tabela AVAILABLE_ORDER.

Endpoint será utilizado quando o subcanal estiver configurado para stop embalamento.

Configurado para stop embalamento, todos os pedidos que conter mais de 1 produto, não será efetuado a cotação do embalamento automaticamente, sendo necessário criar o embalamento.

Altura, Largura e Comprimento sendo enviados em centímetros. Peso enviado em quilo.

Request URL:

https://api3.sisfrete.com.br/api/embalamento

curl :

Campos do json do embalamento

{
embalamentos [{

altura number($double)
comprimento number($double)
largura number($double)
peso number($double)
quantidade number($double)
}
numeroDoPedido string
preco number($double)
}

Exemplo json: