Preparação para chamar serviços Web do MarcomCentral

Nesse procedimento, você importa arquivos WSDL e instala um certificado de segurança. Se o seu ambiente requer um servidor proxy para se comunicar com o MarcomCentral, configure o sistema para usá-lo. Você decide se deseja chamar operações em serviços Web do MarcomCentral além das operações chamadas pela amostra de dispositivo de entrada, fluxos de trabalho e notificação. Nesse caso, você aprende os requisitos das operações e testa manualmente os serviços Web.
Para se preparar para chamar serviços Web do MarcomCentral:
  1. Antes de fazer chamadas para serviços Web do MarcomCentral, execute as seguintes tarefas:
    1. Importe um arquivo WSDL para cada serviço Web do MarcomCentral que planeja chamar.

      RICOH ProcessDirector cria objetos de solicitação SOAP de operações SOAP no arquivo WSDL. Você especifica um prefixo que RICOH ProcessDirector adiciona aos nomes das operações SOAP ao criar os objetos. Um objeto de solicitação SOAP permite que o RICOH ProcessDirector determine a versão do SOAP e outras informações necessárias para fazer uma chamada correta para o serviço Web.

    2. Instale um certificado de segurança para o MarcomCentral no computador primário do RICOH ProcessDirector.
    3. Se o seu ambiente requer um servidor proxy para se comunicar com o MarcomCentral, configure o sistema para usá-lo.
    Para obter mais informações, consulte as tarefas relacionadas.
  2. Se você tiver uma loja do MarcomCentral de produção, recomendamos a configuração uma loja de teste.

    Se você tiver uma loja de teste, pode testar o dispositivo de entrada, etapas CallSOAPService e notificações sem processar ou encerrar acidentalmente pedidos reais. Você pode estabelecer que a comunicação entre o RICOH ProcessDirector e o MarcomCentral trabalhe com pedidos simples e um processo básico. Você pode adicionar informações a chamadas de serviços Web e testar novas chamadas de serviço Web de forma incremental.

  3. Decida se deseja chamar operações em serviços Web do MarcomCentral além das operações chamadas pela amostra de objetos no recurso MarcomCentral Connect.

    A amostra de objetos chama essas operações em serviços Web do MarcomCentral:

    • A amostra de dispositivo de entrada MarcomReceiveOrders chama a operação GetOrdersByDate no serviço Web Pedido e recupera pedidos nas horas e datas especificadas.

    • A etapa CallSOAPService na amostra de fluxo de trabalho MarcomProcessOrders chama a operação GetJobTicketsByOrderNumber no serviço Web Bilhete de Tarefa e recupera todos os bilhetes de tarefas de um pedido.

    • A etapa CallSOAPService na amostra de fluxo de trabalho MarcomProcessJobTicket chama a operação GetJobTicketByLineItem no serviço Web Bilhete de Tarefa e recupera o URL do arquivo para download.

    • A amostra de notificação MarcomCloseoutOrder chama a operação CloseoutByOrder no serviço Web Encerramento de Pedido e envia o ID de pedido de um pedido concluído.

      Você pode adicionar informações para faturamento, guias de embalagens e liquidações à propriedade Solicitar carga da notificação. Como alternativa, você pode fazer operações de faturamento, guias de embalagens e liquidações individualmente, chamando os serviços Web Fatura, Guia de Embalagem e Liquidação. Para obter mais informações, consulte a documentação dos serviços Web do MarcomCentral.

    Você pode chamar qualquer operação em qualquer serviço Web do MarcomCentral, incluindo Catálogo e Inventário de uma etapa CallSOAPService ou uma notificação de serviço Web SOAP.

  4. Para chamar outra operação em um serviço Web do MarcomCentral por fluxos de trabalho RICOH ProcessDirector que processam pedidos do MarcomCentral e bilhetes de tarefas:
    1. Conheça os requisitos para a comunicação com a operação do serviço Web do MarcomCentral:

      • Os valores para solicitar dados

      • O formato dos dados fornecidos na resposta

      Consulte a documentação do MarcomCentral sobre serviço Web ou consulte a empresa.

    2. Execute um teste do manual com autenticação no MarcomCentral e que solicita uma resposta do serviço Web. Verifique se o serviço Web executa a ação desejada.

      Muitos navegadores têm plug-ins, como o Boomerang para Google Chrome, que testam chamadas de serviço Web para clientes SOAP.

      Quando a chamada de teste atualiza as informações corretas na loja e retorna a resposta correta, a carga está pronta para ser usada no RICOH ProcessDirector.

    3. Salve a carga em um arquivo de texto.
    4. Para colocar a chamada da operação de serviço Web em uma etapa CallSOAPService, adicione a etapa ao definir o fluxo de trabalho para processar pedidos ou bilhetes de tarefas. Copie a carga dentro da propriedade Solicitar carga da etapa CallSOAPService.
    5. Para colocar a chamada da operação de serviço Web em uma notificação, adicione a notificação após os fluxos de trabalho para processar pedidos ou bilhetes de tarefas. Copie a carga dentro da propriedade Solicitar carga da notificação.

Após se preparar para chamar serviços Web do MarcomCentral, você estará pronto para se preparar para recuperar pedidos do MarcomCentral.

Related information:

MarcomCentral Connect
Importação de arquivos WSDL
Instalação de um certificado de segurança para um site
Configuração do sistema para usar um servidor proxy
Tópico principal: Configuração para processar pedidos do MarcomCentral