O Supplier Portal é uma ferramenta que permite a comunicação entre loja e fábrica, proporcionando maior agilidade e rastreabilidade no processo de pedidos.
Este guia apresenta os procedimentos para a integração dos pedidos de compra entre o FoccoLOJAS, o Supplier Portal e o 2020 Manager.
A integração ocorre da seguinte forma entre os produtos Cyncly:
Acesso rápido do conteúdo deste artigo:
Habilitação da Integração no FoccoLOJAS
Geração e Envio de Pedidos de Compra
Preenchimento da Descrição da Ordem de Compra
Responsável pelo Pagamento da Ordem de Compra
Ordens de Compra de Assistência Técnica
Campos Enviados ao Gateway (e serviço do 2020)
Habilitação da Integração no FoccoLOJAS
No cadastro do fornecedor em Compras - Cadastros Gerais - Fornecedores - Parâmetros deve ser habilitada a opção de integração com o Supplier Portal.
Para habilitar a integração:
1. Acesse Compras - Cadastros Gerais - Fornecedores - Parâmetros.
2. Ative a opção Habilitar Integração com o Supplier Portal.
Quando este parâmetro Habilitar Integração com o Supplier Portal estiver habilitado, todas as operações de geração e envio de pedidos para esse fornecedor seguirão o fluxo de integração descrito abaixo.
Geração e Envio de Pedidos de Compra
1. Conversão da Negociação no 2020 Manager - Ganhar negociação
Antes da geração das ordens de compra o FoccoLOJAS verifica se a negociação vinculada ao projeto está convertida no 2020 Manager:
- Esta verificação é feita para pedidos normais quanto para pedidos de Assistência Técnica (AT).
- O sistema aguarda o retorno desta consulta para dar continuidade ao processo.
- Caso a negociação já esteja convertida no 2020 Manager, o fluxo segue normalmente para a geração dos pedidos.
- Se o retorno indicar que a negociação não pôde ser convertida, o processo é interrompido e as mensagens de erro retornadas pelo 2020 Manager são apresentadas ao usuário na tela do FoccoLOJAS.
2. Geração das Ordens de Compra no Supplier Portal
Após a conversão da negociação ser bem-sucedida:
- O FoccoLOJAS comunica o 20202 Manager para geração das ordens de compra referentes aos ambientes/assistências.
- Caso as ordens sejam criadas com sucesso, o FoccoLOJAS realiza uma consulta à ordem de compra. Com base nos dados retornados pelo Supplier, os pedidos de compra são gerados no FoccoLOJAS exatamente conforme as informações recebidas, garantindo total consistência entre os sistemas.
- Ordens canceladas não são importadas nem geram pedidos no FoccoLOJAS.
3. Tratamento de Erros na Geração
- Se ocorrer erro na criação da ordem no Supplier Portal, o pedido não é gerado no FoccoLOJAS.
- O usuário é informado por meio de mensagem exibida na tela, com o detalhamento do problema retornado pelo FoccoLOJAS ou pelo 2020 Manager.
4. Tratamento de Erros no Envio e Reenvio de Pedidos
- Em caso de erro no envio do pedido para o Supplier (falha na liberação da ordem), o usuário pode realizar novas tentativas de envio, sem bloqueio automático do processo no FoccoLOJAS.
- O bloqueio de um novo envio só ocorre se a liberação da ordem de compra no Supplier for concluída com sucesso.
- Enquanto a ordem não for liberada com sucesso, o pedido permanecerá disponível para nova tentativa de envio, apresentando ao usuário as mensagens de erro ou crítica recebidas do Supplier Portal.
IMPORTANTE: neste fluxo, o FoccoLOJAS não utiliza mais as regras de negócio padrão do sistema para geração de pedidos de compra. Os pedidos são criados exclusivamente com base nos dados retornados pela integração com o Supplier (dados de capa e itens).
Itens do pedido de compra
1. O FoccoLOJAS não realiza o envio dos itens do pedido para o Supplier Portal
- O FoccoLOJAS não envia os itens do pedido diretamente para o Supplier Portal.
- Na geração da ordem de compra, é enviado ao Supplier Portal um comando para criação das ordens com base no HASH da negociação. Esse HASH é gerado na revisão de ambientes ou na assistência técnica, por meio da integração direta com o Promob via APIs.
2. Alteração de itens na revisão de ambientes
- Para fornecedores integrados ao Supplier Portal, não é permitido incluir, alterar ou excluir itens manualmente.
- Toda edição de itens deve ser feita via importação do projeto pelo Promob, garantindo a integridade dos dados.
- Tentativas de alteração manual serão bloqueadas com mensagem orientando o usuário a realizar ajustes no Promob.
Preenchimento da Descrição da Ordem de Compra
- A descrição da ordem de compra é obrigatória, devido a um parâmetro do Supplier Portal que obriga o preenchimento para liberação da ordem de compra.
- O conteúdo da descrição da ordem de compra será enviado conforme o parâmetro de Sistema - Configurações - Compras - Ordem de compra automática, o mesmo que já é utilizado para popular o campo ordem de compra nos pedidos gerados pelo FoccoLOJAS.
- As tags iniciadas com PedidoCompra não são atendidas na integração com Supplier Portal, pois o pedido criado no FoccoLOJAS é posterior a criação no Supplier Portal.
Observações do Pedido
- As observações registradas no FoccoLOJAS em Compras - Pedidos de Compra - Pedido de Compra - Aba Observações são enviadas ao Supplier Portal.
- O usuário pode preencher manualmente este campo antes do envio.
Responsável pelo Pagamento da Ordem de Compra
O campo ResponsavelPedido é enviado conforme o parâmetro em Sistema - Configurações - Compras.
Opções:
| Parâmetro | Faturamento | Valor Enviado |
| Cliente Final | Cliente | CLIENTE_FINAL |
| Cliente Específico | Loja | LOJA |
| Cliente Específico Permite Edição | Definido no momento da geração | CLIENTE_FINAL ou LOJA |
Ordens de Compra de Assistência Técnica
Além dos pedidos de compra através do fluxo da revisão dos ambientes do contrato, também é possível enviar os pedidos de assistência técnica via Supplier Portal.
- Nos pedidos de assistência é enviado um novo campo IsTechnicalAssistence no serviço. Este campo é enviado como true em caso de assistência e como false na revisão.
IMPORTANTE: isso pode ser consultado no log de comunicação de envio. - Não é possível enviar os pedidos com itens de assistência adicionados manualmente, apenas os itens que foram importados automaticamente do Promob através da integração direta por APIs.
- Se o parâmetro de integração com o Supplier estiver ativo no fornecedor e forem gerados/enviados pedidos de assistência técnica, será disparado um serviço que fará a criação das ordens de assistência no Supplier e criará os pedidos de assistência no FoccoLOJAS com base nas ordens retornadas. Após a geração desses pedidos, ao realizar a ação de envio, é enviado outro disparo de serviço para o Supplier, liberando as ordens de assistência técnica.
Consulta de Pedidos
Ao consultar um pedido no FoccoLOJAS:
1. O status da respectiva ordem é verificado no Supplier Portal.
2. São retornadas e armazenadas as seguintes informações:
- Situação do pedido (supplierStatus)
- Número do pedido do fornecedor (numberRequestSupplier)
- Data prevista para faturamento (deliveryDate)
- Histórico (mensagens e eventos do Supplier)
Conversão dos status:
| Supplier Portal | FoccoLOJAS |
| Aguardando Liberação | Bloqueado Fornecedor |
| Liberado | Liberado Fornecedor |
| Em Produção | Liberado Fornecedor |
| Produzido | Liberado Fornecedor |
| Em expedição | Em Carga Fornecedor |
| Faturado | Faturado Fornecedor |
| Em Transporte | Atendido Fornecedor |
| Não recebido | Atendido Fornecedor |
| Cancelado | Cancelado |
Histórico de Integração
Ao acessar o pedido de compra, na aba Histórico é exibido, quando disponível:
- Números dos pedidos
- Status
- Mensagens de retorno das consultas realizadas
Campos Enviados ao Gateway (e serviço do 2020)
Abaixo estão listados os campos enviados ao GATEWAY e posteriormente ao serviço do 2020:
- AccountID (Loja)
- ProjectID (GUID Revisão)
- NegotationID (GUID)
- SpaceID (GUID)