English
Español
Web service Com.senior.g5.co.mct.imp.escrituracao.integracao.notasfiscais
Tem como objetivo fazer a integração dos documentos fiscais (notas fiscais de entrada, notas fiscais de saída e controle de embarque) das Gestões de Mercado e Suprimentos para a Gestão de Tributos, conforme é feito pela tela F660INT. A reincidência da integração das Notas Fiscais de um mesmo período fará com que as alterações feitas na Gestão de Tributos sejam perdidas, pois esta integração não mantém as alterações feitas.
Tipo de execução
Para cada tipo de execução, existem diferentes parâmetros que podem ser comuns a todas as portas.
Autenticação
Caso seja utilizada alguma forma de autenticação para integração de informações através de web services, é necessário identificar o tipo no parâmetro <encryption>, conforme seus valores possíveis.
Campos numéricos
Orientação válida para qualquer campo de web service que possui objetivo de receber valores, independentemente do seu tipo ser Integer, Double e String. Estas orientações devem ser seguidas nas requisições efetuadas via SOAP e em execuções efetuadas através do SGI, relatórios e regras LSP.
Campos que representam valores monetários, quantidade e percentual e estão declarados como String
- Envio no formato ZZZZ,ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com vírgula, e não com ponto
- Obrigatória a utilização do zero a direita. Por exemplo, se o valor for 350,20, a requisição deve ser enviada com este exato valor. Se o valor enviado for enviado como 350,2, o sistema não irá interpretar a requisição adequadamente
Exemplo:
number(005,2) = 350,20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
number(015,2): 35000,20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
number(008,4) = 3200,2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
Campos que representam valores monetários, quantidade e percentual e não estão declarados como String
- Envio no formato ZZZZ.ZZ
- É fundamental não enviar os campos numéricos com separador de milhar, pois ocorrerá erro ao executar a requisição
- Obrigatória a utilização do separador decimal com ponto, e não com vírgula
Exemplo:
- number(005,2) = 350.20 - o sistema espera que o número digitado contenha até 3 casas antes da vírgula e obrigatoriamente duas após;
- number(015,2): 35000.20 - o sistema espera que o número digitado contenha até 13 casas antes da vírgula e obrigatoriamente duas após;
- number(008,4) = 3200.2074 - o sistema espera que o número digitado contenha até 4 casas antes da vírgula e obrigatoriamente duas após.
WSDL
- Síncrono: http://servidor:1234/g5-senior-services/sapiens_Synccom_senior_g5_co_mct_imp_escrituracao_integracao_notasfiscais?wsdl
- Assíncrono: http://servidor:1234/g5-senior-services/sapiens_Asynccom_senior_g5_co_mct_imp_escrituracao_integracao_notasfiscais?wsdl
- Agendamento: http://servidor:1234/g5-senior-services/sapiens_Schedulecom_senior_g5_co_mct_imp_escrituracao_integracao_notasfiscais?wsdl
Porta
Integrar
Executa o web service com.senior.g5.co.mct.imp.escrituracao.integracao.notasfiscais, porta Integrar.
Necessita autenticação: Sim.
Situação da versão: Atual.
Versão: 1.
Versão atual:1.
Requisição:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:Integrar>
<user>String</user>
<password>String</password>
<encryption>Integer</encryption>
<parameters>
<empresa>Integer</empresa>
<tipoIntegracao>Integer</tipoIntegracao>
<integrarNotaFiscalEntrada>String</integrarNotaFiscalEntrada>
<integrarNotaFiscalSaida>String</integrarNotaFiscalSaida>
<integrarControleEmbarque>String</integrarControleEmbarque>
<idePle>Integer</idePle>
<abrangenciaUsuario>String</abrangenciaUsuario>
<abrangenciaFornecedor>String</abrangenciaFornecedor>
<abrangenciaCliente>String</abrangenciaCliente>
<abrangenciaControleEmbarque>String</abrangenciaControleEmbarque>
<abrangenciaFilial>String</abrangenciaFilial>
<abrangenciaSerieEntrada>String</abrangenciaSerieEntrada>
<abrangenciaSerieSaida>String</abrangenciaSerieSaida>
<abrangenciaControleDeclaracaoExportacao>String</abrangenciaControleDeclaracaoExportacao>
<estado>String</estado>
<abrangenciaNotaFiscalEntrada>String</abrangenciaNotaFiscalEntrada>
<abrangenciaNotaFiscalSaida>String</abrangenciaNotaFiscalSaida>
<abrangenciaTransportadoras>String</abrangenciaTransportadoras>
<periodoInicial>DateTime</periodoInicial>
<periodoFinal>DateTime</periodoFinal>
</parameters>
</ser:Integrar>
</soapenv:Body>
</soapenv:Envelope>
Parâmetros da requisição:
| Nome | Preenchimento | Tipo | Descrição |
|---|---|---|---|
| empresa | Obrigatório | Integer | Number(004) - Código da empresa |
| tipoIntegracao | Obrigatório | Integer | Number(001) - Tipo de Integração - [ 0=Notas Fiscais não Integradas;1=Notas Fiscais já Integradas;2=Todas Notas Fiscais ] |
| integrarNotaFiscalEntrada | Obrigatório | String | String(001) - Integrar Nota Fiscal Entrada - S/N |
| integrarNotaFiscalSaida | Obrigatório | String | String(001) - Integrar Nota Fiscal Saída - S/N |
| integrarControleEmbarque | Obrigatório | String | String(001) - Integrar Controle de Embarque - S/N |
| idePle | Opcional | Integer | Number(009) - Identificador do Plano de Execução |
| abrangenciaUsuario | Opcional | String | String(255) - Abrangência Usuário |
| abrangenciaFornecedor | Opcional | String | String(255) - Abrangência Fornecedor |
| abrangenciaCliente | Opcional | String | String(255) - Abrangência Cliente |
| abrangenciaControleEmbarque | Opcional | String | String(255) - Abrangência Controle de Embarque |
| abrangenciaFilial | Opcional | String | String(255) - Abrangência Filial |
| abrangenciaSerieEntrada | Opcional | String | String(255) - Abrangência Série Nota Fiscal de Entrada |
| abrangenciaSerieSaida | Opcional | String | String(255) - Abrangência Série Nota Fiscal de Saída |
| abrangenciaControleDeclaracaoExportacao | Opcional | String | String(255) - Abrangência Controles de Declaração de Exportação |
| estado | Opcional | String | String(002) - Estado |
| abrangenciaNotaFiscalEntrada | Opcional | String | String(255) - Abrangência Nota Fiscal de Entrada |
| abrangenciaNotaFiscalSaida | Opcional | String | String(255) - Abrangência Nota Fiscal de Saída |
| abrangenciaTransportadoras | Opcional | String | String(255) - Abrangência Transportadoras |
| periodoInicial | Obrigatório | DateTime | Date(DD/MM/YYYY) - Período Inicial |
| periodoFinal | Obrigatório | DateTime | Date(DD/MM/YYYY) - Período Final |
Resposta:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://services.senior.com.br">
<soapenv:Body>
<ser:IntegrarResponse>
<result>
<erros>
<mensagemErro>String</mensagemErro>
</erros>
<mensagemRetorno>String</mensagemRetorno>
<tipoRetorno>Integer</tipoRetorno>
<retornosProcessados>
<mensagemProcessado>String</mensagemProcessado>
</retornosProcessados>
<erroExecucao>String</erroExecucao>
</result>
</ser:IntegrarResponse>
</soapenv:Body>
</soapenv:Envelope>
Atributos da resposta:
| Nome | Tipo | Descrição |
|---|---|---|
| Erros | Opcional | Lista dos erros. |
| Erros.mensagemErro | Opcional | Itens da lista de erros, contendo todos os erros encontrados durante o processamento da rotina por filial. |
| MensagemRetorno | Obrigatório | Mensagem de Retorno de Processamento. |
| TipoRetorno | Obrigatório | Tipo de Retorno de Processamento - Opções: 0 = Processado, -1 = Erro na Solicitação |
| RetornosProcessados | Opcional | Lista dos registros processados com sucesso. |
| RetornosProcessados.mensagemProcessado | Opcional | Itens da lista dos registros processados com sucesso, contendo todos os registros que foram processados com sucesso durante o processamento da rotina por filial. |
| ErroExecucao | Opcional |
Indica erros ocorridos no servidor ao executar o serviço, podendo conter os seguintes valores: Vazio ou nulo, indicando que a execução foi feita com sucesso; A mensagem do erro ocorrido no servidor. |
English
Español
