--- title: "Criar Cotação" method: POST path: "/v1/companies/{company_id}/quotations" tags: ["QuotationAPI"] --- # Criar Cotação `POST /v1/companies/{company_id}/quotations` ### Sobre esta API: Esta API disponibiliza opções de preços e prazos da Loggi nas plataformas parceiras, em tempo real, conforme as características do envio e do parceiro e informações de companyId, shipFrom, shipTo, packages, pickupTypes ou externalServiceIds (SISUs). ### Mais alguns detalhes: Mesmo com poucas informações preenchidas, a API disponibiliza os preços e os prazos mais adequados ao parceiro. Ainda assim, para obter um retorno de estimativa de preço e prazo mais preciso, recomendamos o preenchimento de todos os campos obrigatórios. A cotação de preços é feita levando em consideração: - envio - origem e destino; - pacote - pesos, dimensões e características; - perfil do parceiro. - tipo de coleta. ## Path parameters - `company_id` string, required ## Request body - union — Objeto que representa a criação de uma cotação. - object - `shipFrom` union, required — Objeto que representa um endereço nacional em formato dos Correios ou uma representação alternativa de endereços. Os objetos correios, lines e widget são mutuamente exclusivos. - object - `correios` object — Objeto que contém informações detalhadas do endereço compatível com o formato da API dos Correios. - `logradouro` string, required — Nome da rua. Tamanho mínimo 1 caractere e Tamanho máximo 128 caracteres. - `numero` string — Número do endereço. Tamanho máximo 8 caracteres. Caso não possua número, informar com os valores S/N ou s/n - `complemento` string — Informações adicionais para facilitar a localização. Tamanho máximo 128 caracteres. - `bairro` string — Para endereços de Brasília, procure mais informações nos Correios. Em casos que seja usado regiões adminstrativas e se existir bairro, informe entre parentêses. Tamanho mínimo 1 caractere e Tamanho máximo 64 caracteres. - `cep` string, required — CEP do endereço com 8 dígitos. - `cidade` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `uf` string, required — Unidade federativa com dois caracteres. - object - `lines` object — Representação alternativa de endereços utilizando duas linhas e outros componentes. - `addressLine1` string, required — Primeira linha que contempla os dados do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 256 caracteres. - `addressLine2` string — Segunda linha que complementa os dados de endereço descritos em addressLine1. Tamanho máximo 256 caracteres. - `postalCode` string, required — Código postal do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 16 caracteres. - `city` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `state` string, required — Estado do Endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `country` string — País do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 100 caracteres. - object - `widget` object — Representação de endereço utilizando Autocomplete UI Widget + context. - `address` string, required — Dados do endereço. Tamanho máximo 256 caracteres. - `complement` string — Complemento do endereço. Tamanho máximo 256 caracteres. - `placesApiInfo` object — Informações fornecidas pelo Google Maps Place API. - `placeId` string — Um place ID é um identificador textual que identifica exclusivamente um local. - `sessionId` string — Uma string randômica que identifica uma sessão de autocomplete para fins de faturamento. - `userContext` object — Contexto sobre o usuário. - `userIp` string — O endereço IPv4 ou IPv6 do usuário. - `position` object — Posição do usuário utilizando LatLng do Google. https://github.com/googleapis/googleapis/blob/master/google/type/latlng.proto - … - `shipTo` union, required — Objeto que representa um endereço nacional em formato dos Correios ou uma representação alternativa de endereços. Os objetos correios, lines e widget são mutuamente exclusivos. - object - `correios` object — Objeto que contém informações detalhadas do endereço compatível com o formato da API dos Correios. - `logradouro` string, required — Nome da rua. Tamanho mínimo 1 caractere e Tamanho máximo 128 caracteres. - `numero` string — Número do endereço. Tamanho máximo 8 caracteres. Caso não possua número, informar com os valores S/N ou s/n - `complemento` string — Informações adicionais para facilitar a localização. Tamanho máximo 128 caracteres. - `bairro` string — Para endereços de Brasília, procure mais informações nos Correios. Em casos que seja usado regiões adminstrativas e se existir bairro, informe entre parentêses. Tamanho mínimo 1 caractere e Tamanho máximo 64 caracteres. - `cep` string, required — CEP do endereço com 8 dígitos. - `cidade` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `uf` string, required — Unidade federativa com dois caracteres. - object - `lines` object — Representação alternativa de endereços utilizando duas linhas e outros componentes. - `addressLine1` string, required — Primeira linha que contempla os dados do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 256 caracteres. - `addressLine2` string — Segunda linha que complementa os dados de endereço descritos em addressLine1. Tamanho máximo 256 caracteres. - `postalCode` string, required — Código postal do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 16 caracteres. - `city` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `state` string, required — Estado do Endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `country` string — País do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 100 caracteres. - object - `widget` object — Representação de endereço utilizando Autocomplete UI Widget + context. - `address` string, required — Dados do endereço. Tamanho máximo 256 caracteres. - `complement` string — Complemento do endereço. Tamanho máximo 256 caracteres. - `placesApiInfo` object — Informações fornecidas pelo Google Maps Place API. - `placeId` string — Um place ID é um identificador textual que identifica exclusivamente um local. - `sessionId` string — Uma string randômica que identifica uma sessão de autocomplete para fins de faturamento. - `userContext` object — Contexto sobre o usuário. - `userIp` string — O endereço IPv4 ou IPv6 do usuário. - `position` object — Posição do usuário utilizando LatLng do Google. https://github.com/googleapis/googleapis/blob/master/google/type/latlng.proto - … - `packages` object[] — Lista de pacotes associado à cotação de frete. - `weightG` integer, required — Peso do pacote em gramas. Valor máximo 30000. - `lengthCm` integer, required — Comprimento do pacote em centímetros. Valor máximo 100. - `widthCm` integer, required — Largura do pacote em centrímetros. Valor máximo 100. - `heightCm` integer, required — Altura do pacote em centímetros. Valor máximo 100. - `goodsValue` object, required — Valor total de todos os produtos a serem transportados dentro de um pacote. Há um valor máximo em reais, consulte nosso time de vendas para mais detalhes. - `currencyCode` string, required — Código de três letras para as moedas definido no ISO 4217. - `units` string, int64, required — Todas as unidades do montante. - `nanos` integer, required — Componente fracionário em nanos, i.e., centavos vezes 10 milhões. Ler mais em https://github.com/googleapis/googleapis/blob/master/google/type/money.proto - `externalServiceIds` string[], required — Lista de identificadores externos do serviço. Preencher este campo ou o campo pickupTypes. Nunca ambos. - object - `shipFrom` union, required — Objeto que representa um endereço nacional em formato dos Correios ou uma representação alternativa de endereços. Os objetos correios, lines e widget são mutuamente exclusivos. - object - `correios` object — Objeto que contém informações detalhadas do endereço compatível com o formato da API dos Correios. - `logradouro` string, required — Nome da rua. Tamanho mínimo 1 caractere e Tamanho máximo 128 caracteres. - `numero` string — Número do endereço. Tamanho máximo 8 caracteres. Caso não possua número, informar com os valores S/N ou s/n - `complemento` string — Informações adicionais para facilitar a localização. Tamanho máximo 128 caracteres. - `bairro` string — Para endereços de Brasília, procure mais informações nos Correios. Em casos que seja usado regiões adminstrativas e se existir bairro, informe entre parentêses. Tamanho mínimo 1 caractere e Tamanho máximo 64 caracteres. - `cep` string, required — CEP do endereço com 8 dígitos. - `cidade` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `uf` string, required — Unidade federativa com dois caracteres. - object - `lines` object — Representação alternativa de endereços utilizando duas linhas e outros componentes. - `addressLine1` string, required — Primeira linha que contempla os dados do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 256 caracteres. - `addressLine2` string — Segunda linha que complementa os dados de endereço descritos em addressLine1. Tamanho máximo 256 caracteres. - `postalCode` string, required — Código postal do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 16 caracteres. - `city` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `state` string, required — Estado do Endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `country` string — País do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 100 caracteres. - object - `widget` object — Representação de endereço utilizando Autocomplete UI Widget + context. - `address` string, required — Dados do endereço. Tamanho máximo 256 caracteres. - `complement` string — Complemento do endereço. Tamanho máximo 256 caracteres. - `placesApiInfo` object — Informações fornecidas pelo Google Maps Place API. - `placeId` string — Um place ID é um identificador textual que identifica exclusivamente um local. - `sessionId` string — Uma string randômica que identifica uma sessão de autocomplete para fins de faturamento. - `userContext` object — Contexto sobre o usuário. - `userIp` string — O endereço IPv4 ou IPv6 do usuário. - `position` object — Posição do usuário utilizando LatLng do Google. https://github.com/googleapis/googleapis/blob/master/google/type/latlng.proto - … - `shipTo` union, required — Objeto que representa um endereço nacional em formato dos Correios ou uma representação alternativa de endereços. Os objetos correios, lines e widget são mutuamente exclusivos. - object - `correios` object — Objeto que contém informações detalhadas do endereço compatível com o formato da API dos Correios. - `logradouro` string, required — Nome da rua. Tamanho mínimo 1 caractere e Tamanho máximo 128 caracteres. - `numero` string — Número do endereço. Tamanho máximo 8 caracteres. Caso não possua número, informar com os valores S/N ou s/n - `complemento` string — Informações adicionais para facilitar a localização. Tamanho máximo 128 caracteres. - `bairro` string — Para endereços de Brasília, procure mais informações nos Correios. Em casos que seja usado regiões adminstrativas e se existir bairro, informe entre parentêses. Tamanho mínimo 1 caractere e Tamanho máximo 64 caracteres. - `cep` string, required — CEP do endereço com 8 dígitos. - `cidade` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `uf` string, required — Unidade federativa com dois caracteres. - object - `lines` object — Representação alternativa de endereços utilizando duas linhas e outros componentes. - `addressLine1` string, required — Primeira linha que contempla os dados do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 256 caracteres. - `addressLine2` string — Segunda linha que complementa os dados de endereço descritos em addressLine1. Tamanho máximo 256 caracteres. - `postalCode` string, required — Código postal do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 16 caracteres. - `city` string, required — Cidade do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `state` string, required — Estado do Endereço. Tamanho mínimo 1 caractere e Tamanho máximo 32 caracteres. - `country` string — País do endereço. Tamanho mínimo 1 caractere e Tamanho máximo 100 caracteres. - object - `widget` object — Representação de endereço utilizando Autocomplete UI Widget + context. - `address` string, required — Dados do endereço. Tamanho máximo 256 caracteres. - `complement` string — Complemento do endereço. Tamanho máximo 256 caracteres. - `placesApiInfo` object — Informações fornecidas pelo Google Maps Place API. - `placeId` string — Um place ID é um identificador textual que identifica exclusivamente um local. - `sessionId` string — Uma string randômica que identifica uma sessão de autocomplete para fins de faturamento. - `userContext` object — Contexto sobre o usuário. - `userIp` string — O endereço IPv4 ou IPv6 do usuário. - `position` object — Posição do usuário utilizando LatLng do Google. https://github.com/googleapis/googleapis/blob/master/google/type/latlng.proto - … - `packages` object[] — Lista de pacotes associado à cotação de frete. - `weightG` integer, required — Peso do pacote em gramas. Valor máximo 30000. - `lengthCm` integer, required — Comprimento do pacote em centímetros. Valor máximo 100. - `widthCm` integer, required — Largura do pacote em centrímetros. Valor máximo 100. - `heightCm` integer, required — Altura do pacote em centímetros. Valor máximo 100. - `goodsValue` object, required — Valor total de todos os produtos a serem transportados dentro de um pacote. Há um valor máximo em reais, consulte nosso time de vendas para mais detalhes. - `currencyCode` string, required — Código de três letras para as moedas definido no ISO 4217. - `units` string, int64, required — Todas as unidades do montante. - `nanos` integer, required — Componente fracionário em nanos, i.e., centavos vezes 10 milhões. Ler mais em https://github.com/googleapis/googleapis/blob/master/google/type/money.proto - `pickupTypes` string[], required — Lista de tipos de coleta. Preencher este campo ou o campo externalServiceIds. Nunca ambos. ## Response `200` Quotation criada com sucesso. Para cada pacote fornecido na requisição, uma lista de "quotations" é retornada no response. Caso a Loggi não seja capaz de realizar o serviço para um dos pacotes informados, uma lista de "quotations" vazia será retornada. - QuoteResponse - `packagesQuotations` object — Objeto que representa a cotação de cada pacote. - `quotations` object[] — Opções de frete para um pacote. Um pacote pode ter até duas opções (Loggi Econômico e Loggi Expresso). - `price` object - `totalAmount` object — Preço total do frete com taxas e impostos incluídos. - `currencyCode` string, required — Código de três letras para as modedas definido no ISO 4217. - `units` string, int64, required — Todas as unidades do montante. - `nanos` integer, required — Componente fracionário em nanos, i.e., centavos vezes 10 milhões. Ler mais em https://github.com/googleapis/googleapis/blob/master/google/type/money.proto - `baseAmount` object — Preço do frete sem taxas e impostos incluídos. - `currencyCode` string, required — Código de três letras para as modedas definido no ISO 4217. - `units` string, int64, required — Todas as unidades do montante. - `nanos` integer, required — Componente fracionário em nanos, i.e., centavos vezes 10 milhões. Ler mais em https://github.com/googleapis/googleapis/blob/master/google/type/money.proto - `taxesAndFees` object — Taxas e impostos incluídos. - `pis` object - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object — Valor do imposto com a porcentagem do rate_tax. - … - `cofins` object — Valor do imposto com a porcentagem do rate_tax. - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object - … - `gris` object - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object — Valor do imposto com a porcentagem do rate_tax. - … - `advalorem` object - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object — Valor do imposto com a porcentagem do rate_tax. - … - `icms` object - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object — Valor do imposto com a porcentagem do rate_tax. Obrigatório quando o frete é intermunicipal ou interestadual - … - `iss` object - `rate_tax` string — Porcentagem aplicada no imposto. - `amount` object — Valor do imposto com a porcentagem do rate_tax. Obrigatório quando o frete está dentro da mesma cidade. - … - `sloInDays` integer — Tempo de entrega dentro do prazo estipulado em dias. - `freightType` 'FREIGHT_TYPE_EXPRESS' | 'FREIGHT_TYPE_ECONOMIC' — Tipos de entregas disponíveis. - `freightTypeLabel` string — Label do tipo de entrega. Poderá ser usado como output na UI. - `pickup_type` 'PICKUP_TYPE_SPOT' | 'PICKUP_TYPE_DEDICATED' | 'PICKUP_TYPE_MILK_RUN' | 'PICKUP_TYPE_DROP_OFF' — Tipos de coletas disponíveis. - `externalServiceIds` string — Identificador externo do serviço. ## Other responses - `400` — Mensagem do cliente não segue a especificação - `401` — Falha de autenticação - `403` — Sem autorização para acessar o serviço - `404` — Recurso não encontrado - `429` — Requisições massivas bloqueadas - `500` — Erro interno - `503` — Serviço temporariamente indisponivel --- [API](https://skmtc.net/loggi/apis/authentication.md) · [All operations](https://skmtc.net/loggi/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggi/authentication/revisions/46512f6e2419/schema)