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:

CODE

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