Como realizar requisições via SoapUI – Integrações 360

Requisitos

  • Liberação de acesso: solicite à NDD a liberação do cliente para acesso à API

  • Usuário administrador: é necessário ter um usuário cadastrado no portal 360 com permissão de administrador master

  • Instalar a ferramenta SoapUI

{1045711C-1EB6-4163-931F-C4E22AD5EFC7}-20260430-190620.png

Como funciona?

As APIs do Portal 360 seguem o padrão SOAP. Para usá-las, envie uma requisição POST ao endereço do Web Service, incluindo os parâmetros exigidos por cada método, conforme nossa documentação: Integration Kit

Cada Web Service possui seu endpoint respectivo, conforme o Data Center.

Exemplo (PrintJobsData - DC BR1):

https://api-printjobs.nddprint.com/PrintJobsWS/PrintJobsData.asmx

Realizando testes pelo SoapUI

Passo 1: Criando um projeto SOAP 1

  1. Abra o SoapUI e clique em SOAP:

{DE7CD991-71BB-44CD-A76A-7E00416D044C}-20260430-190956.png
  1. Em Project Name, defina o nome do projeto

  2. Em Initial WSDL, insira o endpoint do Web Service seguido de ?WSDL

Exemplo: https://api-printjobs.nddprint.com/PrintJobsWS/PrintJobsData.asmx?WSDL

  1. Marque a opção “Create Requests

  2. Clique em “OK”

{41477562-AB2A-4288-B4F6-76EDA13BC5E6}-20260430-191532.png

Assim, a ferramenta gerará requisições prontas, exigindo apenas o preenchimento dos parâmetros.

Passo 2: Alterar os parâmetros da requisição

  1. Acesse a Request gerada pela ferramenta no projeto criado:

{518397CB-6E6D-472E-8DCF-D722592BE21B}-20260430-191637.png
  1. Altere os dados nas tags conforme o exemplo abaixo:

{710CC5FD-1C2F-46D3-92C6-B9760E9A5B1D}-20260430-191732.png

Paramêtros do método:

  • enterpriseName: Nome da empresa;

  • enterpriseKey: Chave da empresa;

  • authDomainName: Nome do domínio;

  • authLogonName: Logon do usuário (administrador);

  • authPassword: Senha do usuário criptografada;

  • filterDate: Data dos trabalhos de impressão (aaaa-MM-dd);

  • filterDateType:

    • Tipo do filtro de data: 0 = data da impressão, 1 = data de inclusão;

  • fieldsList: Lista dos campos que serão retornados pela função. Devem ser especificados separando-os por ponto e vírgula ';'.

    • Exemplo: LogonName;Printer;PagesMono;PagesColor.

Observação

A senha do usuário deve ser criptografada usando os scripts de exemplo em: Criptografia

Passo 3: envie a requisição

  1. Envie a requisição através do botão:

{A861D47B-9B4C-4C3E-89E5-06CBE47BD643}-20260430-192154.png

Observação

O retorno será uma string JSON e deve ser convertido conforme as orientações da seção: Manipulando os Retornos