Documentação em construção

Modelo Datasul

...

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:

URL

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:

Image Added

Autorização

Na aba de autorização, selecione o tipo Basic e informe os dados de usuário e senha:

Image Added

Header

No header da requisição, informe o tipo do conteúdo:

Content-Type: application/json

Body

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"
        }
    ]
}

Explicando cada um dos campos do corpo da simulação de impostos

"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.

Modelo Genérico

Protocolo HTTP REST

Modelo de autenticação: Básica Usuário/Senha

...