API

Nossa Api é acessivel atráves do endpoint
https://fastshipping.ciawn.com.br/v1/
Esse é o endpoint padrão para o acesso.
A Api segue a arquitetura restful onde todas as respostas e requisições são feitas via json. A seguir você encontrará mais exemplos de como utilizar a Api Fast Shipping.

Para se autenticar em nossa Api você irá precisar de um token que deverá ser enviado pela url. Esse token é disponibilizado quando se cria um cadastro em nosso sistema (aqui) Com o token em mãos, todas requisições deverão ter o parametro
token (GET)
exemplo
https://fastshipping.ciawn.com.br/v1/shipping?token=seuTokenAqui

Esta rota permite utilizar um formulario de usuario para fazer o cadastro de informações básicas. Como cep de origem e tipo de serviços a serem consultados nos correios.
Esta rota possibilita a incorporação do formulário diretamente em seu sistema, a partir de uma tag iframe. Entre em contato para saber mais.

Exemplo de chamada: https://fastshipping.ciawn.com.br/v1/users?token=seuTokenAqui

Serviço de consulta de fretes. Para utilizar o serviço de consulta você deverá seguir o padrão abaixo.
Importante: Você deve preencher as suas informações de endereço disponíveis em:
https://fastshipping.ciawn.com.br/v1/users?token=seuTokenAqui
para poder realizar a sua requisição.
Exemplo de chamada: https://fastshipping.ciawn.com.br/v1/shipping?token=seuTokenAqui

                    
                    {
                        "destination_postal_code" : "07252000",
                        "destination_country" : "BR",
                        "destination_state" : "SP",
                        "destination_city" : "Cidade",
                        "origin_postal_code" : "",
                        "origin_country" : "",
                        "origin_state" : "",
                        "origin_city" : "",
                        "products" : [
                            {
                                "weight" : 1,
                                "height" : 10,
                                "length" : 16,
                                "width" : 11.5,
                                "unit_price" : 11.25,
                                "quantity" : 1,
                                "sku" : "MLB673212405",
                                "id" : "559c45d77c5580f1155d0fec"
                            }
                        ]
                    }
                    
                  

A requisição terá um código 200 de aparencia como essa abaixo. Você pode optar por mostrar ou não mostrar os logs de erro em nossas configurações!

                    
                    [
                        {
                            "method": "Sedex sem Contrato",
                            "company": "Correios",
                            "price": "15,90",
                            "estimate": "8"
                        },
                        {
                            "method": "E-Sedex com Contrato",
                            "error": {
                                "code": 1,
                                "message": "Serviço indisponível para este código administrativo."
                            }
                        },
                        {
                            "method": "Sedex 10",
                            "error": {
                                "code": 1,
                                "message": "Erro desconhecido, entre em contato com os correios'."
                            }
                        }
                    ]
                    
                  

Abaixo a lista de descrição de cada campo.

Campo	Descrição	Tipo	Obrigatorio
destination_postal_code	CEP de destino	String	Sim
destination_country	Sigla do país de destino *	String	Não
destination_state	Sigla do estado de destino	String	Não
destination_city	Nome da cidade de destino	String	Não
origin_postal_code	CEP de origem	String	Não
origin_postal_code	CEP de origem	String	Não
origin_country	Nome do país de origem	String	Não
origin_state	Sigla do estado de origem	String	Não
origin_city	Nome da cidade de origem	String	Não
Array de Produtos - products[]
weight	Peso do item a ser enviado	Dec(10,2)	Sim
height	Altura da embalagem do item a ser enviado	Dec(10,2)	Não
width	Largura da embalagem do item a ser enviado	Dec(10,2)	Não
length	Comprimento da embalagem do item a ser enviado	Dec(10,2)	Não
unit_price	Preço uniário	Dec(10,2)	Não
quantity	Quantidade de itens a serem enviados	Integer	Sim
sku	SKU do produto no sistema do lojista	String	Sim
id	ID do produto	String	Sim

Sobre os campos de retorno.

Campo	Descrição	Tipo de Dados
method	Nome do método de envio retornado pelos Correios	String
company	Empresa que retornou o frete	String
price	Preço estimado do envio	Dec(10,2)

Nessa rota você vai obter todos os dados de uma encomenda já enviada, assim você pode colocar os dados direto no seu site e não precisar fazer seu cliente ir até os correios para acessar esta informação.

Exemplo de chamada: https://fastshipping.ciawn.com.br/v1/tracking/RE419472475BR?token=seuTokenAqui

Código	Erro
-1	Erro interno do sistema
1	Valores obrigatórios do usuário não preenchidos no sistema
2	Dimensões fora do permitido
3	Valor acima do permito
4	CEP incorreto
5	Peso inválido ou acima do permitido