Documentação em construção
...
Abaixo está o escopo do cálculo de imposto do Datasul.
A integração recebe a solicitação da aplicação via Carte, busca, processa e retorna para a mesma.
Abaixo estão exemplos via POSTMAN:
Na URL para o Datasul, o formato será o seguinte:
POST {{URL}/api/ftp/v2/ItemTaxSimulationPublic
Substitua a variável URL pelo caminho da API, informado pelo cliente.
Exemplo:
Na aba de autorização, selecione o tipo Basic e informe os dados de usuário e senha:
No header da requisição, informe o tipo do conteúdo:
Content-Type: application/json
No corpo da mensagem, substitua os dados da ordem de venda nas tags correspondentes.
Exemplo:
Corpo de uma mensagem de exemplo:
{
"SalesType": "N",
"CustomerId": "000001",
"CustomerUnit": "01",
"CustomerIdDelivery": "000001",
"CustomerUnitDelivery": "01",
"CustomerType": "F",
"Payment": "001",
"DiscountPercentage1": 10,
"DiscountPercentage2": 10,
"DiscountPercentage3": 10,
"DiscountPercentage4": 10,
"Currency": 1,
"Freight": 10,
"Insurance": 0,
"Expense": 0,
"ListofProducts": [
{
"ItemId": "01",
"ProductId": "3395979",
"Quantity": 10,
"UnitaryValue": 100,
"TotalValue": 1000,
"ItemDiscountPercentage": 10,
"ItemDiscountValue": 100,
"OperationType": "02"
},
{
"ItemId": "02",
"ProductId": "92.01.101-2",
"Quantity": 10,
"UnitaryValue": 100,
"TotalValue": 1000,
"ItemDiscountPercentage": 10,
"ItemDiscountValue": 100,
"OperationType": "01"
}
]
}
"SalesType": "N"
Tipo da venda, usa o valor “N" fixo
"CustomerId": "42150391"
Código do cliente, extraído do campo customer.code selecionado no cabeçalho da ordem de venda
"CustomerUnit": "005"
Código da loja, extraído do campo addresses.code selecionado no cabeçalho da ordem de venda
"CustomerIdDelivery": "42150391"
Código do cliente, extraído do campo customer.code selecionado na entrega da ordem de venda
"CustomerUnitDelivery": "0050"
Código da loja, extraído do campo addresses.code selecionado na entrega da ordem de venda
"CustomerType": "F"
Tipo do cliente, usa o valor “F” fixo
"Payment": "003"
Código da condição de pagamento, campo paymentTerm.code selecionado no cabeçalho da ordem de venda
"DiscountPercentage1": 0, "DiscountPercentage2": 0, "DiscountPercentage3": 0, "DiscountPercentage4": 0
Percentual de desconto em cascata, atualmente não enviamos informações nestes campos em específico.
"Currency": 0
Moeda selecionada na ordem de venda, campo currency.auxiliaryCode. Por padrão utiliza-se a moeda Real
"Freight": 0
Valor do frete inserido na ordem de venda, campo deliveryOrders.freightValue
"Insurance": 0
Valor do seguro, não enviamos atualmente,
"Expense": 0
Valor de despesas acessórias, não enviamos atualmente.
"ListofProducts"."ItemId": “1”
Número sequencial de cada item dentro da ordem de venda, iniciando com valor 1, incrementando a cada item
"ListofProducts"."ProductId": "3707-011-000"
Código do produto inserido nos itens da ordem de venda, campo product.code
"ListofProducts"."Quantity": 1
Quantidade do item em questão inserido nas ordens de venda
"ListofProducts"."UnitaryValue": 22
Valor unitário do item inserido nas ordens de venda (valor cheio, não considera desconto)
"ListofProducts"."TotalValue": 19.8
Valor total do item inserido nas ordens de venda considerando o desconto [quantity * (unitaryValue - itemDiscountValue)]
"ListofProducts"."ItemDiscountPercentage": 10
Percentual de desconto inserido no item da ordem de venda
"ListofProducts"."ItemDiscountValue": 2.2
Valor do desconto inserido no item da ordem de venda
"ListofProducts"."OperationType": "501"
Tipo de operação, campo orderType.code, representado pela escolha do campo tipo de ordem no cabeçalho do pedido e expandido para todos os itens da ordem de venda.
Protocolo HTTP REST
Modelo de autenticação: Básica Usuário/Senha
...