Documentação Integração ERP Customizável
Fluxo de Integração
Métodos
Integrar com o ERP
É necessário disponibilizar um endpoint (POST) para que sejam enviados os dados do pedido e seja feita a integração com o ERP customizável.
Exemplo de requisição:
{
"id": "6017134100635",
"frete": {
"valor": 27.50,
"transportadora": "Logística Rápida e Eficiente Ltda."
},
"cliente": {
"nome": "José",
"sobrenome": "Silva",
"email": "josesilva@example.com",
"cpf_cnpj": "123.456.789-00"
},
"endereco_entrega": {
"nome": "José Silva",
"sobrenome": "Silva",
"cep": "12345-678",
"logradouro": "Rua das Flores",
"numero": "123",
"bairro": "Centro",
"cidade": "São Paulo",
"uf": "SP",
"pais": "BR",
"complemento": "Ap. 101",
"telefone": "(11) 98765-4321"
},
"endereco_cobranca": {
"nome": "José Silva",
"sobrenome": "Silva",
"cep": "12345-678",
"logradouro": "Rua das Flores",
"numero": "123",
"bairro": "Centro",
"cidade": "São Paulo",
"uf": "SP",
"pais": "BR",
"complemento": "Ap. 101",
"telefone": "(11) 99999-9999"
},
"pagamento": {
"forma": "credit_card",
"parcelas": "2",
"nsu": "98765432"
},
"itens": [
{
"sku": "12345",
"produto": "Produto 1",
"quantidade": 3,
"valor_desconto": 10.5,
"valor_unitario": 29.99,
"valor_final": 78.99,
"gramas": 150
},
{
"sku": "67890",
"produto": "Produto 2",
"quantidade": 2,
"valor_desconto": 5.25,
"valor_unitario": 15.99,
"valor_final": 25.48,
"gramas": 200
}
],
"valor_total": 104.47
}
Enviar nota fiscal
Para seguir com o fluxo de integração é necessário enviar os dados da nota fiscal para o endpoint https://apilogistica.checkstore.app/invoice (POST).
HEADER
TOKEN_FULLCOMM = Disponível no OMS FullComm
Body da requisição:
Nome do campo | Valor esperado |
---|---|
xml | URL do XML da nota fiscal |
numero | Número da nota fiscal |
serie | Série da nota fiscal |
id | ID do pedido informado na hora da integração |
Atualizar estoque
Para seguir com o fluxo de integração é necessário enviar os dados da nota fiscal para o endpoint https://apilogistica.checkstore.app/stock (PUT).
HEADER
TOKEN_FULLCOMM = Disponível no OMS FullComm
Body da requisição:
Nome do campo | Valor esperado |
---|---|
produtos | Array com os produtos |
produtos.sku | SKU do produto |
produtos.quantidade | Quantidade em estoque |