Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Nome

Descritivo

Exemplo

Observações

Authorization

Conteúdo do token obtido no passo de autenticação do usuário

eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZF91c3VhcmlvIjozMiwiY25waiI6IjAxLjgwNC4zNDUvMDAwMS02MCIsImV4cCI6MTUwMDA1MzYxN30.-ZvhWFYI8fyx66b3kZY1UVUrfaWUTioV3_M6K2wiPGM

Content-Type

tipo do formato de envio

application/json

Accept

tipo do formato de envio

application/json

Params

1

Item

Chave

Conteúdo

Obrigatório

codEnt

Código da Entidade que se deseja os dados

Sim

2

codEmpresa

Código da Empresa onde ocorrerá a venda

Sim3

dtPrevFat

Data prevista para Faturamento (devido vigência de preços). Formato: dd/mm/yyyy

Não. Se não informada será considerada a data atual.4

retiraEntrega

E ou R para indicar se é retira ou entrega

Não. Se não informado será considerado como Retira.

5

codDep

Código do Depósito onde ocorrerá a venda.

Não. Se não informado será considerado o depósito padrão de vendas da empresa. 6

Nota

Caso seja informado um código inexistente o custo retornado é influenciado pois a API pega a primeira vigência de custo cadastrada

codTransp

Código do Motorista

Não. Se não informado será considerado o Motorista vinculado ao cliente.7

seqFrota

Sequencial do frota principal

Não. Se não informado será considerado o Frota vinculado ao cliente.8

codProd

Código do produto

Opcional, se passar, calcula somente para o produto. Caso contrário, calcula para todos os produtos de venda do cliente.9

codPg

Código das condições de pagamento.

Opcional, se passar, calcula para essa condição de pagamento, caso contrário, calcula para a condição de pagamento padrão do cliente.

seqEnderecoEntrega

Sequencial do endereço de entrega que será considerado para o frete, etc

Opcional, caso não seja passado, será considerado o sequencial de endereço do cadastro do cliente.

Nota

Se passar algum sequencial válido, o endereço de entrega retornado pela API será o correspondente a este sequencial e não mais o endereço de entrega do cadastro da entidade.

Método

GET

Exemplo de envio:

View file
namedados_preco.json
. Exemplo de retorno:
View file
nameretorno_dados_venda.json

...

Bloco de código
 {
    "dadosVenda": [
        {
            "CodPgProd": "998",
            "CodProd": "01",
            "Custo": 1.843334,
            "CustoFinancReal": 0.2,
            "EnderecoEntrega": "fgdfgfd,  -  - / - ",
            "FreteUnitReal": 0,
            "Preco": 1.91,
            "PrecoMaximo": -1,
            "PrecoMinimo": -1,
            "Produto": "GASOLINA C",
            "Seguro_Aliquota": 10,
            "Seguro_ValorUnitario": 0.191
        }
    ],
    "CodEnt": 1,
    "CodEmpresa": 1,
    "CodDep": "1",
    "DtPrevFat": "2024-08-21",
    "RetiraEntrega": "R",
    "CodTransp": "00032",
    "SeqFrota": 772,
    "CodPgCli": "998",
    "PrazoCli": 10,
    "endereco_entrega": {
        "Endereco": "fgdfgfd",
        "Numero": null,
        "Complemento": null,
        "Bairro": null,
        "CodigoDNC": null,
        "Municipio": null,
        "UF": null,
        "CEP": null,
        "CodPais": null,
        "Latitude": null,
        "Longitude": null,
        "Fone": null,
        "CNPJ": "12764122000133",
        "IE": null,
        "RzSocial": "DEMO DISTRIBUIDORA LTDA"
    }
}

A quantidade de casas decimais do CustoFinancReal depende do perfil #CasasPrUnit. limitada a 06 casas decimais. Para mais informações, ver https://futura.atlassian.net/wiki/spaces/SPT/pages/2918974349/Painel+Vendas?search_id=b452df13-384c-4fe4-bb1b-274a818be835&additional_analytics=queryHash---a4db473c943dcc1d157ebd8f9d806eeed8cb81aa9aa2c3d3343436fc622c0e7c

A quantidade de casas decimais do FreteUnitPadrao depende do perfil #Casas decimais Frete Unitario limitada a 06 casas decimais. Para mais informações, ver Painel Fretes

Retorno Sem Sucesso

Será retornado um objeto JSON com o motivo da falha (normalmente  um erro de autenticação caso o token tenha expirado ou seja inválido ou alguma regra de negócio não atendida. O status da resposta sempre será diferente de 200.

...