Incluir Negativação

SERASA - Negativação

Webservices SERASA

Endpoints

Produção: http://www.soawebservices.com.br/webservices/producao/serasa/negativacao.asmx

Test-Drive: http://www.soawebservices.com.br/webservices/test-drive/serasa/negativacao.asmx

Método: Incluir

Descrição: Inclui uma restrição no documento apresentado na base da SERASA

Headers:

POST /webservices/producao/serasa/negativacao.asmx HTTP/1.1
Host: www.soawebservices.com.br
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "SOAWebServices/Incluir"

Requisição SOAP/XML:

<?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>
    <Incluir xmlns="SOAWebServices">
      <Credenciais>
        <Email>string</Email>
        <Senha>string</Senha>
      </Credenciais>
      <InclusaoNegativacao>
        <Devedores>
          <Devedor>
            <Documento>string</Documento>
            <TipoDevedor>Principal or CoObrigado</TipoDevedor>
          </Devedor>
          <Devedor>
            <Documento>string</Documento>
            <TipoDevedor>Principal or CoObrigado</TipoDevedor>
          </Devedor>
        </Devedores>
        <Restricao>
          <CodigoRestricao>string</CodigoRestricao>
          <Contrato>string</Contrato>
          <NossoNumero>string</NossoNumero>
          <DataVencimento>string</DataVencimento>
          <DataFinalContrato>string</DataFinalContrato>
          <Valor>decimal</Valor>
          <RestricaoCheque>
            <CodigoBanco>string</CodigoBanco>
            <Agencia>string</Agencia>
            <ContaCorrente>string</ContaCorrente>
            <NumeroCheque>string</NumeroCheque>
            <Alinea>string</Alinea>
          </RestricaoCheque>
          <Comunicado>
            <TipoComunicado>FAC or BoletoBancario or ContasPublicas or AR</TipoComunicado>
          </Comunicado>
        </Restricao>
      </InclusaoNegativacao>
    </Incluir>
  </soap:Body>
</soap:Envelope>

Regras para Inclusão:

XML Node	Campo	Tipo	Descrição	Obrigatório
Credenciais		Objeto	Credenciais de acesso	Sim
	Email	string	Email de credenciais	Sim
	Senha	string	Senha de credenciais	Sim
InclusaoNegativacao		Objeto	Dados da Negativação	Sim
Devedores		Objeto Lista	Lista de Devedores	Sim
Devedor		Objeto	Dados do Devedor: Só pode existir 1 "Principal. Só pode existir 1 CoObrigado e é opcional	Sim
Documento		string	Documento do Devedor (CPF ou CNPJ)	Sim
TipoDevedor		string	Tipo do Devedor: "Principal" ou "CoObrigado"	Sim
Restricao		Objeto	Dados da Restrição	Sim
CodigoRestricao		string	Codigo do tipo de restricao, Veja Tabela de Codigos de Restrições	Sim
Contrato		string	Seu numero de contrato para sua identificação (Máximo 16 bytes)	Sim
NossoNumero		string	Seu numero de identificacao para esta restricao (Máximo 9 bytes, nao pode se repetir o mesmo numero)	Sim
DataVencimento		Data	Formato DD/MM/AAAA.	Sim
DataFimContrato		Data	Caso seja um contrato com data de vencimento favor informar	Opcional
Valor		Numerico	Valor original da Divida	Sim
RestricaoCheque		Objeto	Dados do Cheque quando o CodigoRestricao for "DC" ou "DE"	Somente se o CodigoRestrição for "DC" ou "DE", neste caso os campos abaixos passam a serem obrigatórios
CodigoBanco		Numérico	Numero do Banco sem digito	Sim
Agencia		Numérico	Numero da Agencia Bancária sem Digito	Sim
ContaCorrente		Numérico	Numero da Conta Corrente com Digito sem hifen	Sim
NumeroCheque		Numérico	Numero do Cheque com Digito e sem hifen	Sim
Alinea		string	Alinea de devolução do Cheque, somente alineas: 12,13 e 14	Sim
Comunicado		Objeto		Sim
TipoComunicado		string	Utilizar sem "FAC", outras modalidades irão ser disponibilizadas em breve.	Sim

Resposta SOAP/XML:

<?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>
    <IncluirResponse xmlns="SOAWebServices">
      <IncluirResult>
        <UniqueID>string</UniqueID>
        <Ambiente>TestDrive or Producao</Ambiente>
        <Credor>
          <DocumentoCredor>string</DocumentoCredor>
          <NomeCredor>string</NomeCredor>
        </Credor>
        <Devedores>
          <DevedorIdentificacao>
            <Documento>string</Documento>
            <TipoDevedor>Principal or CoObrigado</TipoDevedor>
            <Nome>string</Nome>
            <Endereco xsi:nil="true" />
          </DevedorIdentificacao>
          <DevedorIdentificacao>
            <Documento>string</Documento>
            <TipoDevedor>Principal or CoObrigado</TipoDevedor>
            <Nome>string</Nome>
            <Endereco xsi:nil="true" />
          </DevedorIdentificacao>
        </Devedores>
        <Restricao>
          <CodigoRestricao>string</CodigoRestricao>
          <Contrato>string</Contrato>
          <NossoNumero>string</NossoNumero>
          <DataVencimento>string</DataVencimento>
          <DataFinalContrato>string</DataFinalContrato>
          <Valor>decimal</Valor>
          <RestricaoCheque>
            <CodigoBanco>string</CodigoBanco>
            <Agencia>string</Agencia>
            <ContaCorrente>string</ContaCorrente>
            <NumeroCheque>string</NumeroCheque>
            <Alinea>string</Alinea>
          </RestricaoCheque>
          <Comunicado>
            <TipoComunicado>FAC or BoletoBancario or ContasPublicas or AR</TipoComunicado>
          </Comunicado>
        </Restricao>
        <DataHoraInclusao>string</DataHoraInclusao>
        <NegativacaoErros>
          <Erro>
            <CodigoErro>string</CodigoErro>
            <Mensagem>string</Mensagem>
          </Erro>
          <Erro>
            <CodigoErro>string</CodigoErro>
            <Mensagem>string</Mensagem>
          </Erro>
        </NegativacaoErros>
        <Transacao>
          <Status>boolean</Status>
          <CodigoStatus>string</CodigoStatus>
          <CodigoStatusDescricao>string</CodigoStatusDescricao>
        </Transacao>
      </IncluirResult>
    </IncluirResponse>
  </soap:Body>
</soap:Envelope>