Fastcommerce Developers Center

Cálculo externo de frete por LOCALIDADES

Para que o cálculo de frete seja feito por sistemas externos, basta criar um conversor JSON, que receberá os dados do pedido e as localides de origem e destino. Este conversor deverá retornar um JSON com as opções de frete e os seus respectivos valores. Opcionalmente retornará também o prazo de entrega de cada opção.

Seguem abaixo os formatos do JSON que enviaremos para a URL de integração e do JSON que esperamos receber como retorno. Esta URL deverá ser informada no caminho ENVIO & FRETE > Formas de envio > Tabela de preços > URL de consulta, no site administrativo da loja. Para utilizar esta URL, selecione a opção [ 5 ] Utilizar cálculo externo por localidade deste caminho.

ATENÇÃO: Se a loja vende somente para o Brasil, utilize a opção [ 3 ] Utilizar faixas de CEP (Brasil). Caso queira utilizar um serviço de cálculo externo por CEP, configure este serviço no caminho ENVIO & FRETE > Cálculo externo.

Para maiores detalhes, clique aqui.

1 - ENVIO

                
quote={
  "freightQuoteRequest":{
    "fromAddress": {
      "line1": "123 street name",
      "line2": "",
      "city": "new york",
      "state": "xx",
      "country": "Brazil",
      "countryCode": "BR",
      "postalCode": "111111111",
      "phone": "112222222222222"
    },
    "shippingAddress": {
      "line1": "123 street name",
      "line2": "",
      "city": "new york",
      "state": "xx",
      "country": "Brazil",
      "countryCode": "BR",
      "postalCode": "111111111",
      "phone": "112222222222222"
    },
    "totalAmount": 9999.99,
    "totalWeight": 9999.99,
    "hasBulky": true/false,
    "calculationParameters":{
      "giftPacking": 99,
      "packagePrice": 99.99,
      "fixedFreight": 99.99,
      "insurancePercentage": 9.99,
      "additionalValue": 9.99,
      "additionalWeight": 9.99,
      "additionalDays": 9,
      "freightMultiplier": 9.99,
      "freeFreightForZeroWeight": true/false
      "partnerId": 999999,
      "partnerFreightDiscount": 99.99
    },
    "products":[
      {
        "id": 99999999,
        "sku": "aaaaaaaaa",
        "name": "aaaaaaaaaaaa",
        "category": "bbbbbbbb",
        "barcode": "12344",
        "filters": "aaa=123",
        "color": "amarelo",
        "simpleDescriptor1": "aaaaaaaa",
        "simpleDescriptor2": "aaaaaaaa",
        "simpleDescriptor3": "aaaaaaaa",
        "specialDescriptor1": "aaaaaaaa",
        "specialDescriptor2": "aaaaaaaa",
        "specialDescriptor3": "aaaaaaaa",
        "quantity": 99,
        "unitValue": 999.99,
        "unitWeight": 10.234,
        "bulky": true/false,
        "unitHeight": 123.99,
        "unitLength": 123.99,
        "unitWidth": 123.99
      }
    ]
  }
}
                
              

Obs: O envio do JSON de cotação é feito via POST. O user-agent é Fastcommerce Freight Interface.

2 - RETORNO

Formato do JSON de retorno.

                
{
  "freightQuoteResponse":{
    "err": 123,
    "errDescr": "error description",
    "shippingServices":[
      {
        "serviceName": "International courrier",
        "servicePrice": 6.50,
        "serviceNotes": "12 days"
      },
      {
        "serviceName": "Express delivery",
        "servicePrice": 2.30,
        "serviceNotes": "2 days"
      }
    ]
  }
}
                
              

Obs¹: O retorno do JSON de cotação deverá ser feito via POST. Utilize um user-agent exclusivo.

Obs²: Em operação bem sucedida o retorno será Err=0 e errDescr=""

3 - Dicionário de dados

JSON ENVIO

JSON RETORNO

4 - Histórico de versão

A versão atual da API é 1.1.