Para realizar a integração de um sistema WMS com o KPL, o primeiro passo é realizar a criação da interface.
O tipo da interface a ser cadastrada deve ser WS WMS (opção “Ábacos – Web Services – WMS”). Caso precise de maiores informações sobre interface clique aqui.
FLUXOS POSSÍVEIS:
Fluxo A – conformidade em todos os itens do pedido:
- PedidosDisponiveis
- ConfirmarRecebimentoSepararPedido
- CheckoutItem
Fluxo B – não conformidade com algum item:
- PedidosDisponiveis
- ConfirmarRecebimentoSepararPedido
- CheckoutItem
- ConcluirSeparacaoNaoConformidade
Fluxo C – não conformidade com todos os itens:
- PedidosDisponiveis
- ConfirmarRecebimentoSepararPedido
- InformaRupturaTotal
Fluxo D – apenas para clientes que não utilizam checkout
- PedidosDisponiveis
- ConfirmarRecebimentoSepararPedido
- ConcluirSeparacaoMercadoria (sempre vai alterar o status do pedido para PRONTO PARA FATURAR)
DETALHES DO PROCESSO:
Ao usar o método PedidosDisponiveis, sugerimos configurar o ponto de integração do status do pedido em Aguardando Separação. Isso significa que o WMS vai consultar apenas os pedidos neste status.
Atenção: somente serão integrados os itens com saldo reservado maior que zero.
Essa configuração (de retornar pedidos neste status – aguardando separação) é feita nas abas da configuração de interface:
Ao capturar um pedido via método PedidosDisponiveis:
1 2 3 4 5 6 7 8 9 |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <PedidosDisponiveis xmlns="http://www.kplsolucoes.com.br/ABACOSWebService"> <ChaveIdentificacao>string</ChaveIdentificacao> </PedidosDisponiveis> </soap:Body> </soap:Envelope> |
Com o consumo do pedido realizado iniciamos o processo de despacho via API WMS utilizando o método ConfirmarRecebimentoSepararPedido .
1 2 3 4 5 6 7 8 9 |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ConfirmarRecebimentoSepararPedido xmlns="http://www.kplsolucoes.com.br/ABACOSWebService"> <ProtocoloPedido>string</ProtocoloPedido> </ConfirmarRecebimentoSepararPedido> </soap:Body> </soap:Envelope> |
Utilizando o método ConfirmarRecebimentoSepararPedido, o pedido dentro do KPL ficará com status da separação “Em Separação” e o status do pedido permanecerá como “Aguardando Separação”:
No menu: Comercial e Faturamento / Movimentações / Pedidos / Expedição / Separar mercadorias
verifique que o pedido mudou o estagio e a cor de fundo ficou azul.
O próximo passo é efetuar o checkout do envio, que é a conferencia dos itens deste pedido.
Utilizaremos o método: CheckoutItem.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <CheckoutItem xmlns="http://www.kplsolucoes.com.br/ABACOSWebService"> <ChaveIdentificacao>string</ChaveIdentificacao> <NumeroPedido>string</NumeroPedido> <CodigoCaixa>string</CodigoCaixa> <ItensPedido> <DadosItensCheckout> <CodigoProduto>string</CodigoProduto> <CodigoBarrasProduto>string</CodigoBarrasProduto> <Quantidade>double</Quantidade> <Rastreabilidade>string</Rastreabilidade> <Estoque>string</Estoque> <Observacao>string</Observacao> <Identidade>string</Identidade> </DadosItensCheckout> <DadosItensCheckout> <CodigoProduto>string</CodigoProduto> <CodigoBarrasProduto>string</CodigoBarrasProduto> <Quantidade>double</Quantidade> <Rastreabilidade>string</Rastreabilidade> <Estoque>string</Estoque> <Observacao>string</Observacao> <Identidade>string</Identidade> </DadosItensCheckout> </ItensPedido> </CheckoutItem> </soap:Body> </soap:Envelope> |
O método CheckoutItem equivale a tela de checkout do KPL:
Lembre-se que o checkout não é necessário se houve ruptura total.
Após realizar o checkout o status da separação entra em separado e o pedido fica pronto para o faturamento.
Com o faturamento realizado, é possível consultar as notas fiscais no método: NotasFiscaisSaidaDisponiveis.
1 2 3 4 5 6 7 8 9 |
<?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <NotasFiscaisSaidaDisponiveis xmlns="http://www.kplsolucoes.com.br/ABACOSWebService"> <ChaveIdentificacao>string</ChaveIdentificacao> </NotasFiscaisSaidaDisponiveis> </soap:Body> </soap:Envelope> |
É possível configurar os estágios que uma nota fiscal é replicada na interface, no grupo de configuração Saída de Notas:
Para verificar as notas fiscais disponíveis acesse o menu: Comercial e Faturamento / Movimentações / Notas Fiscais / Gerenciar Notas Fiscais Eletrônicas.