You are on page 1of 30

SISCOAF

Manual de integrao

Histrico de Verses
Data
Junho/2010
Novembro/2012

Verso
1.0
1.1

Maio/2013
Novembro/2014

1.2
1.3

Descrio
Verso inicial
Alterao dos endereos de testes do webservice
Alterao de detalhamento do nome dos campos de valores para novos
segmentos supervisionados
Incluso anexos

SISCOAF
Manual de integrao
O acesso ao sistema dever ser feito por um usurio previamente cadastrado no sistema, utilizando usurio e
senha ou certificado digital de pessoa fsica ICP-Brasil.
O Envio de comunicaes poder ser feito por webservice, envio de arquivo xml ou atravs de formulrio no
site do SISCOAF. O envio utilizando webservice dever assinar o arquivo xml (descrito neste documento) com um
certificado digital de pessoa fsica (usurio do sistema).
O endereo de homologao do webservice, que poder ser utilizado para testes :
http://treina.siscoaf.serpro.gov.br/coafws/service.asmx
O endereo de produo do webservice, que dever ser utilizado :
https://www.fazenda.gov.br/siscoaf/portugues/coafws/service.asmx
Neste endereo esto as funes disponibilizadas para acesso via webservice, todas as rotinas e o
acionamento das rotinas dever utilizar assinatura digital no xml.
Os arquivos enviados para o sistema atravs de upload de arquivo ou webservice devero ter tamanho mximo
de 01MB. A interpretao das tags xml case sensitive, ou seja, as tags devero ser escritas conforme o leiaute
(maisculas e minsculas), caso contrrio podero apresentar erro na validao do formato.
As tabelas de cdigos de tipo de envolvimento e erros de validao esto disponveis no sistema no item
Comunicar em Lote

Webservice
Todas as chamadas do webservice devero ser assinadas por certificado digital de pessoa fsica. Todos os
webservice possuem somente um parmetro

1.1

EnviarLoteComunicacao
Funo para enviar lote de comunicaes

1.2

ReciboLoteComunicacao
Funo para solicitar recibo de lote enviado.

1.3

RetificarLoteComunicacao
Funo para envio de lote de retificao de comunicaes.

1.4

CancelarLoteComunicacao
Funo para cancelamento de comunicaes enviadas.

1.5

Leiaute Assinatura digital

A assinatura do comunicante dever ser feita na TAG <Ocorrencias> identificada pelo atributo Id, cujo
contedo dever ser um identificador que est especificado para cada funo do webservice(envio, retificao,
cancelamento e recibo).

Campo

Pai

Ocor.

Regras e Informaes Associadas

AS01

Signature

AS02

SignedInfo

AS01

1-1

Grupo da Informao da assinatura

AS03

CanonicalizationM

AS02

1-1

Grupo do Mtodo de Canonicalizao

AS04

Algorithm

AS03

1-1

Atributo Algorithm de CanonicalizationMethod:


http://www.w3.org/TR/2001/REC-xml-c14n-20010315

AS05

SignatureMethod

AS02

1-1

Grupo do Mtodo de Assinatura

AS06

Algorithm

AS05

1-1

Atributo Algorithm de SignedInfo:


http://www.w3.org/2000/09/xmldsig#rsa-sha1

AS07

Reference

AS02

1-1

Grupo do Mtodo de Reference

AS08

URI

AS07

1-1

Atributo URI da tag Reference

AS09

Transforms

AS07

1-1

Grupo do algorithm de Transform

AS10

unique_Transf_Alg

AS09

1-1

Regra para o atributo Algorithm do Transform

AS11

Transform

AS09

1-1

Grupo de Transform

AS11

1-1

Atributos vlidos Algorithm do Transform:


http://www.w3.org/TR/2001/REC-xml-c14n-20010315
http://www.w3.org/2000/09/xmldsig#envelopedsignature

AS12

Algorithm

ser nico.

AS13

XPath

AS11

1-1

XPath

AS14

DigestMethod

AS07

1-1

Grupo do Mtodo de DigestMethod

AS15

Algorithm

AS14

1-1

Atributo Algorithm de DigestMethod:


http://www.w3.org/2000/09/xmldsig#sha1

AS16

DigestValue

AS07

1-1

Digest Value (Hash SHA-1 Base64)

AS17

SignatureValue

AS01

1-1

Grupo do Signature Value

AS18

KeyInfo

AS01

1-1

Grupo do KeyInfo

AS19

X509Data

AS18

1-1

Grupo X509

AS20

X509Certificate

AS19

1-1

Certificado Digital x509 em Base64

Envio de Comunicaes
Para enviar as comunicaes em lote dever ser utilizado o formato xml descrito abaixo.

2.1

Campos a serem Informados no arquivo de envio (ou rea de dados do xml do


webservice)

A coluna Obrigao da tabela indica se obrigatrio o preenchimento do campo com um valor, porm todos os
campos (Tags) devem estar presentes no arquivo XML, mesmo que vazios.
#

Campo

C01

Obrig.

Regras e Informaes Associadas


Identificador da comunicao na origem. Trata-se de
uma nmero gerado e controlado pela prpria pessoa
obrigada. Este utilizado no COAF para controle e
restrio de envio de informao duplicada.

NumOcorrencia

Tipo:
Alfanumrico
Tamanho: 70

CPFCNPJCom

Tipo: Numrico
Tamanhos:
CPF = 11
inteiros
CNPJ = 14
inteiros

SIM

DtInicio

Tipo: Data

SIM

Indica data inicial do fato comunicado

DtFim

Tipo: Data

SIM

Indica data final do fato comunicado. Para fato


ocorrido em dia especfico, deve ser informado o
mesmo valor do campo data inicial.

C02

C03

Tipo

SIM

C04

C05

AgNum

Tipo: Numrico
Tamanho: 10

SIM*

CPF ou CNPJ da pessoa fsica ou jurdica que est


comunicando o fato comunicado. Devero ser
informados apenas nmeros com 11 dgitos para
CPF e 14 para CNPJ, completando com 0
esquerda caso necessrio.

Para o segmento DPF Transporte e Guarda de


valores este campo dever ser preenchido com a
informao:
- Cidade/UF Destino
Para os demais segmentos abaixo no dever ser
preenchido:

C06
C07
C08
C09
C10

AgNome

Tipo: texto
Tamanho: 100

NO

Este campo no necessita de preenchimento.

AgMun

Tipo: texto
Tamanho: 100

SIM

Nome do municpio em que o fato comunicado


ocorreu.

AgUF

Tipo: texto
Tamanho: 2

SIM

Unidade da Federao em que se localiza o


municpio em que o fato comunicado ocorreu

Det

Tipo: Texto
Tamanho: 7000

SIM

Descrio detalhada da anlise feita pela instituio


financeira a respeito do fato comunicado

SIM

Cdigo identificador do tipo de


ocorrncia/enquadramento do fato comunicado

CodEnq

Tipo: Numrico

Campo

Tipo

Obrig.

C11

VlCred

Tipo: Numrico
Desprezar os
centavos

SIM*

Regras e Informaes Associadas


Este campo equivaler seguinte informao de
acordo com o segmento
ANS Planos de Sade
Valor
CFC - Contador - Servios de assessoria,
consultoria, contadoria, auditoria,
aconselhamento ou assistncia
Valor
COAF - Bens de luxo ou de alto valor
Valor total
COAF - Bolsas de mercadorias
Valor do(s) pagamento(s)
COAF - Cartes de crdito
Valor da ocorrncia
COAF Factoring e securitizao de ativos,
ttulos ou recebveis mobilirios
Valor da operao ou dos ativos vendidos
COAF - Jias, pedras e metais preciosos
Valor da operao ou proposta
COAF - Objetos de arte e antiguidades
Valor da operao
COAF - Remessas Alternativas de Recursos
Valor da(s) Transao(es) Nacional(is)
COAF - Servios de assessoria, consultoria,
auditoria, aconselhamento ou assistncia
Valor total
COFECI - Promoo imobiliria compra/venda
imveis
Valor do Imvel objeto da operao
COFECON - Economista - Servios de
assessoria, consultoria, auditoria,
aconselhamento ou assistncia
Valor
CVM - Mercado de Valores Mobilirios
Valor
DPF - Transporte e Guarda de Valores
Valor Transportado
DREI - Juntas Comerciais
Valor
PREVIC - Previdncia Complementar
Valor da Operao/Contribuio
SEAE - Loterias
Valor do Prmio
Outros setores previstos na Lei n 9.613/1998
Valor total

Campo

Tipo

Obrig.

C12

VlDeb

Tipo: Numrico
Desprezar os
centavos

SIM*

Regras e Informaes Associadas


Este campo equivaler seguinte informao de
acordo com o segmento
COAF - Bens de luxo ou de alto valor
Valor pago em espcie
COAF Factoring e securitizao de ativos,
ttulos ou recebveis mobilirios
Valor pago em espcie
COAF - Jias, pedras e metais preciosos
Valor do(s) pagamento(s) em espcie
COAF - Objetos de arte e antiguidades
Valor do(s) pagamento(s) em espcie
COAF - Remessas Alternativas de Recursos
Valor da(s) Transao(es) Internacional(is)
COAF - Servios de assessoria, consultoria,
auditoria, aconselhamento ou assistncia
Valor pago em espcie
COFECI - Promoo imobiliria compra/venda
imveis
Valor da transao/operao
DPF - Transporte e Guarda de Valores
Valor Guardado/Custodiado
SEAE - Loterias
Valor da(s) aposta(s) ou arrecadao
Bens de alto valor de origem rural ou animal
Valor pago em espcie
Outros setores previstos na Lei n 9.613/1998
Valor pago em espcie

Os segmentos no listados devero preencher este


campo com 0(zero)
C13

VlProv

Tipo: Numrico
Desprezar os
centavos

SIM*

Este campo equivaler seguinte informao de


acordo com o segmento
DPF - Transporte e Guarda de Valores
Proposta
SEAE - Loterias
Quantidade de premiaes

Os demais segmentos devero preencher este


campo com 0(zero)
C14

VlProp

Tipo: Numrico
Desprezar os
centavos

SEAE - Loterias
Valor Pago em espcie
SIM*
Este campo dever ser preenchido com 0(zero) para
os demais segmentos:

Campo

Tipo

Obrig.

C15

Regras e Informaes Associadas


CPF ou CNPJ da pessoa fsica ou jurdica envolvida
no fato comunicado. Devero ser informados apenas
nmeros com 11 dgitos para CPF e 14 para CNPJ,
completando com 0 esquerda caso necessrio.
Ex:
<CPFCNPJEnv>00012345602</CPFCNPJEnv>
<CPFCNPJEnv>00001234000145</CPFCNPJEnv>

Tipo: Numrico
Tamanhos:
CPF = 11
inteiros
CNPJ = 14
inteiros

SIM

NmEnv

Tipo: Texto
Tamanho: 150

SIM

Nome da pessoa fsica ou jurdica envolvida no fato


comunicado

TpEnv

Tipo: Numrico
Tamanho:2

SIM

Tipo de envolvimento, cdigo de acordo com tabela


de tipo de envolvimento.

C18 AgNumEnv

Tipo:Numrico
Tamanho: 4

NO

No ser preenchido

C19 AgNomeEnv

Tipo: texto
Tamanho: 100

NO

No ser preenchido

C20 NumConta

Tipo: texto
Tamanho:20

NO

No ser preenchido

C21 DtAbConta

Tipo: Data

NO

No ser preenchido

C22 DtAtuaCad

Tipo: Data

NO

No ser preenchido

CPFCNPJEnv

C16
C17

Caso no tenha a informao de CPF ou CNPJ


informar somente o tipo da pessoa com PF ou PJ no
campo correspondente Ex:
<CPFCNPJEnv>PF</CPFCNPJEnv>
<CPFCNPJEnv>PJ</CPFCNPJEnv>

C23 PObrigada

Tipo: Binrio

SIM

Indica se o envolvido pessoa obrigada no mbito da


Lei n 9.613
0 No Pessoa Obrigada/No possui informao
1 Pessoa Obrigada

C24 PEP

Tipo: Binrio

SIM

Indica se o envolvido pessoa politicamente exposta


0 No PEP/No possui informao
1 PEP

Indica se o envolvido servidor pblico. 5 opes:


0 No servidor/No possui informao
1 - Serv Pblico
2 SPF (Serv. Publ. Federal)
3 SPE (Serv. Publ. Estadual)
C25 ServPub
Tipo: inteiro
SIM
4 SPM (Serv. Publ. Municipal)
Obs: as opes 2, 3 e 4 devero ser utilizadas caso
esteja disponvel a classificao do servidor pblico,
caso contrrio poder ser informado somente o
cdigo 1.
* obrigatrio o preenchimento de pelo menos um campo de Valor (C11 a C14), de acordo com o segmento, os
campos sem valor devero ser preenchidos com valor 0 (zero), nos campos de valores devero ser desprezados os
centavos informando somente o valor inteiro.

2.2

Leiaute do envio de comunicaes


Leiaute da rea de dados do arquivo xml de envio, este leiaute corresponde ao leiaute do arquivo que ser
importado para o sistema.

Campo

A00 LOTE
A01
A02

Pai

Ocor.

Regras e Informaes Associadas

Raiz

1-1

OCORRENCIAS

A00

1-1

Dever conter o ID:SISCOAF + data


Ex: SISCOAF01012009

OCORRENCIA

A01

1-500

Poder haver at 500 ocorrncias em um


arquivo xml

1-1

Identificador da comunicao na origem. Tratase de um nmero gerado e controlado pela


prpria pessoa obrigada. Este utilizado no
COAF para controle e restrio de envio de
informao duplicada.

A03
NumOcorrencia

A02

A04
CPFCNPJCom

A05 DtInicio

CPF ou CNPJ da pessoa fsica ou jurdica que


est comunicando o fato comunicado. Devero
ser informados apenas nmeros com 11
dgitos para CPF e 14 para CNPJ,
completando com 0 esquerda caso
necessrio.

A02

A02

1-1

Indica data inicial do fato comunicado

A02

1-1

Indica data final do fato comunicado. Para fato


ocorrido em dia especfico, deve ser informado
o mesmo valor do campo data inicial.

A02

1-1

A06
DtFim

A07

AgNum

Para o segmento DPF Transporte e Guarda


de valores este campo dever ser preenchido
com a informao:
- Cidade/UF Destino
Para os demais segmentos abaixo no dever
ser preenchido:

A08 AgNome

A02

1-1

Este campo no necessita de preenchimento.

A09

A02

1-1

Nome do municpio em que o fato comunicado


ocorreu.

A02

1-1

Unidade da Federao em que se localiza o


municpio em que o fato comunicado ocorreu

A02

1-1

A10

AgMun
AgUF

A11
Det

Descrio detalhada da anlise feita pela


instituio financeira a respeito do fato
comunicado

Campo

Pai

A12

Ocor.
1-1

VlCred

A02

Regras e Informaes Associadas


Este campo equivaler seguinte informao
de acordo com o segmento
Bens de alto valor de origem rural ou
animal
Valor total
COAF - Bens de luxo ou de alto valor
Valor total
COAF - Bingos
Valor da premiao
COAF - Bolsas de mercadorias
Valor do(s) pagamento(s)
COAF - Cartes de crdito
Valor da ocorrncia
COAF Factoring e securitizao de
ativos, ttulos ou recebveis mobilirios
Valor da operao ou dos ativos vendidos
COAF - Jias, pedras e metais preciosos
Valor da operao ou proposta
COAF - Loterias e Sorteios
Valor do Prmio
COAF - Objetos de arte e antiguidades
Valor da operao
COAF - Remessas Alternativas de
Recursos
Valor da(s) Transao(es) Nacional(is)
COAF - Servios de assessoria,
consultoria, auditoria, aconselhamento ou
assistncia
Valor total
COFECI - Promoo imobiliria
compra/venda imveis
Valor do Imvel objeto da operao
CVM - Mercado de Valores Mobilirios
Valor
DPF - Transporte e Guarda de Valores
Valor Transportado
Feiras, exposies e similares
Valor
Outros rgos - Servios de assessoria,
consultoria, contadoria, auditoria,
aconselhamento ou assistncia
Valor
Outros setores previstos na Lei n
9.613/1998
Valor total
PREVIC - Previdncia Complementar
Valor da Operao/Contribuio
Registros pblicos
Valor
Transferncia de atletas e artistas
Valor

10

Campo

A13

Pai
A02

Ocor.
1-1

VlDeb

Regras e Informaes Associadas


Este campo equivaler seguinte informao
de acordo com o segmento
Bens de alto valor de origem rural ou
animal
Valor pago em espcie
COAF - Bens de luxo ou de alto valor
Valor pago em espcie
COAF - Bingos
Valor da aposta ou arrecadao
COAF Factoring e securitizao de
ativos, ttulos ou recebveis mobilirios
Valor pago em espcie
COAF - Jias, pedras e metais preciosos
Valor do(s) pagamento(s) em espcie
COAF - Loterias e Sorteios
Valor da(s) aposta(s) ou arrecadao
COAF - Objetos de arte e antiguidades
Valor da(s) aposta(s) ou arrecadao
COAF - Remessas Alternativas de
Recursos
Valor da(s) Transao(es) Internacional(is)
COAF - Servios de assessoria,
consultoria, auditoria, aconselhamento ou
assistncia
Valor pago em espcie
COFECI - Promoo imobiliria
compra/venda imveis
Valor da transao/operao
DPF - Transporte e Guarda de Valores
Valor Guardado/Custodiado
Outros setores previstos na Lei n
9.613/1998
Valor pago em espcie

Os segmentos no listados devero preencher


este campo com 0(zero)
A14

A02

1-1

VlProv

Este campo equivaler seguinte informao


de acordo com o segmento
COAF - Loterias e Sorteios
Quantidade de premiaes
DPF - Transporte e Guarda de Valores
Proposta

Os demais segmentos devero preencher este


campo com 0(zero)
A15

A02

1-1

COAF - Loterias e Sorteios


Valor Pago em espcie

VlProp
Este campo dever ser preenchido com
0(zero) para os demais segmentos
A16 ENQUADRAMENTOS

A02

1-1

11

Campo

Pai

Ocor.

A17
CodEnq

A18 ENVOLVIDOS
A19

ENVOLVIDO

A16

1-10

A02

1-1

A18

1-50

A20

CPFCNPJEnv

A19

1-1

Regras e Informaes Associadas


Cdigo identificador do tipo de
ocorrncia/enquadramento do fato comunicado
Poder haver at 10 cdigos de
enquadramento para cada ocorrncia

Poder haver at 50 envolvidos em cada


ocorrncia
CPF ou CNPJ da pessoa fsica ou jurdica
envolvida no fato comunicado. Devero ser
informados apenas nmeros com 11 dgitos
para CPF e 14 para CNPJ, completando com 0
esquerda caso necessrio.
Ex:
<CPFCNPJEnv>00012345602</CPFCNPJEnv>
<CPFCNPJEnv>00001234000145</CPFCNPJEnv
>

Caso no tenha a informao de CPF ou


CNPJ informar somente o tipo da pessoa com
PF ou PJ no campo correspondente Ex:
<CPFCNPJEnv>PF</CPFCNPJEnv>
<CPFCNPJEnv>PJ</CPFCNPJEnv>
A21
A22

NmEnv
TpEnv

A19
A19

1-1

Nome da pessoa fsica ou jurdica envolvida no


fato comunicado

1-1

Tipo de envolvimento, cdigo de acordo com


tabela de tipo de envolvimento.

A23 AgNumEnv

A19

1-1

No ser preenchido

A24 AgNomeEnv

A19

1-1

No ser preenchido

A25 NumConta

A19

1-1

No ser preenchido

A26 DtAbConta

A19

1-1

No ser preenchido

A27 DtAtuaCad

A19

1-1

No ser preenchido

1-1

Indica se o envolvido pessoa obrigada no


mbito da Lei n 9.613
0 No Pessoa Obrigada/No possui
informao
1 Pessoa Obrigada

1-1

Indica se o envolvido pessoa politicamente


exposta
0 No PEP/No possui informao
1 PEP

A19
A28 PObrigada

A19
A29 PEP

12

Campo

Pai

Ocor.

A19

A30 ServPub

1-1

Regras e Informaes Associadas


Indica se o envolvido servidor pblico. 5
opes:
0 No servidor/No possui informao
1 - Serv Pblico
2 SPF (Serv. Publ. Federal)
3 SPE (Serv. Publ. Estadual)
4 SPM (Serv. Publ. Municipal)
Obs: as opes 2, 3 e 4 devero ser utilizadas
caso esteja disponvel a classificao do
servidor pblico, caso contrrio poder ser
informado somente o cdigo 1.

13

2.3

Exemplo Comunicao rea de dados


http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-TesteEnvioGeral.xml

2.4

Exemplo Comunicao com assinatura


Para enviar o arquivo xml utilizando webservice o arquivo dever ser assinado utilizando certificado digital do
responsvel pelo envio, a assinatura dever ser sobre a tag OCORRENCIAS, identificadas pelo ID SISCOAF
+ Data (conforme exemplo abaixo)

<?xml version='1.0' encoding='iso-8859-1'?>


<LOTE>
<OCORRENCIAS ID="SISCOAF03052009">
<OCORRENCIA>
<NumOcorrencia>14</NumOcorrencia>
<CPFCNPJCom>44983111000107</CPFCNPJCom>
<DtInicio>10/11/2014</DtInicio>
<DtFim>10/11/2014</DtFim>
<AgNum></AgNum>
<AgNome></AgNome>
<AgMun>BRASILIA</AgMun>
<AgUF>DF</AgUF>
<Det>Detalhar a operao neste campo</Det>
<VlCred>250000</VlCred>
<VlDeb>0</VlDeb>
<VlProv>0</VlProv>
<VlProp>0</VlProp>
<ENQUADRAMENTOS>
<CodEnq>317</CodEnq>
</ENQUADRAMENTOS>
<ENVOLVIDOS>
<ENVOLVIDO>
<CPFCNPJEnv>56283456321</CPFCNPJEnv>
<NmEnv>MANOEL VALDOIS</NmEnv>
<TpEnv>1</TpEnv>
<AgNumEnv></AgNumEnv>
<AgNomeEnv></AgNomeEnv>
<NumConta></NumConta>
<DtAbConta></DtAbConta>
<DtAtuaCad></DtAtuaCad>
<PObrigada>0</PObrigada>

14

<PEP>0</PEP>
<ServPub>0</ServPub>
</ENVOLVIDO>
<ENVOLVIDO>
<CPFCNPJEnv>34567891000112</CPFCNPJEnv>
<NmEnv>Comercial Teste Ltda</NmEnv>
<TpEnv>25</TpEnv >
<AgNumEnv></AgNumEnv>
<AgNomeEnv></AgNomeEnv>
<NumConta></NumConta>
<DtAbConta></DtAbConta>
<DtAtuaCad></DtAtuaCad>
<PObrigada>0</PObrigada>
<PEP>1</PEP>
<ServPub>2</ServPub>
</ENVOLVIDO>
</ENVOLVIDOS>
</OCORRENCIA>
</OCORRENCIAS>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="# SISCOAF30112008">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<DigestValue>hli0xeO7xxgxm90t5UaAH9ZR4w0=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>Q/XhXmqbs... ...XhXmqbsAz3SutzfNIAvN+k=</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFCTCCA/ ...w4wB0HCY6auKAucqMpi7nPWoVdHDX4bj</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>

</LOTE>

15

2.5

Resposta do envio
Aps o envio da comunicao a mesma ser validada e ser enviado imediatamente um retorno ao
comunicante, disponvel em tela e gerao de arquivo xml, indicando se o envio foi bem sucedido, e em caso
de problemas na validao ser informado o problema encontrado em cada ocorrncia.

2.5.1 Formato resposta validao


Aps o envio da comunicao a mesma ser validada e ser enviado um retorno ao comunicante, indicando
se o envio foi bem sucedido em caso de problemas na validao ser informado o problema encontrado em
cada ocorrncia.
#

Campo

A01 RESPOSTA

Pai

Ocor.

Raiz

1-1

A01

1-1

A02

STATUS
A03
A04

A05

MENSAGENS

A01

Regras e Informaes Associadas

Valores possveis: 1 e 2
1: Nenhum problema foi encontrado na validao
2: Problemas foram encontrados na validao

1-1
Poder haver at 500 mensagens em um arquivo de
resposta de validao

MENSAGEM

A03

1-500

COMUNICACAOORIGEM

A04

1-1

Indica o nmero de controle da ocorrncia pelo comunicante


que a enviou

A04

1-1

Cdigo do erro encontrado na ocorrncia

A06

ERRO

A tabela de cdigo de erros pode ser verificada no endereo:


http://www1.fazenda.gov.br/siscoaf/portugues/listaerros.asp.

16

2.5.2 Exemplo 1 Ocorrncias com problemas.


<?xml version='1.0' encoding='iso-8859-1'?>
<RESPOSTA>
<STATUS>2</STATUS>
<MENSAGENS>
<MENSAGEM>
<COMUNICACAOORIGEM>0004</COMUNICACAOORIGEM>
<ERRO>31</ERRO>
</MENSAGEM>
<MENSAGEM>
<COMUNICACAOORIGEM>0008</COMUNICACAOORIGEM>
<ERRO>31</ERRO></MENSAGEM><MENSAGEM>MENSAGENS>
</RESPOSTA>
Anexo:
http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-RetornoErro.xml

2.5.3 Exemplo 2 Ocorrncias sem problemas.


<?xml version='1.0' encoding='iso-8859-1'?>
<RESPOSTA>
<STATUS>1</STATUS>
<MENSAGENS>
</MENSAGENS>
</RESPOSTA>
Anexo:
http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-Retorno.xml

17

Recibo de envio
No dia seguinte ao envio estar disponvel para o comunicante consulta do recibo de envio das
comunicaes, ser liberado consulta em tela a qual informar o nmero da comunicao do
comunicante, o nmero gerado no SISCOAF, data de envio e um hash. Ser disponibilizado
tambm o recibo em formato xml (para webservices)
#

Campo

Pai

Ocor.

A01 LOTERECIBO

Raiz

1-1

A02

OCORRENCIAS

A03 CPFCNPJCom
A04

DATA

Regras e Informaes Associadas

1-1

Deve ser identificado com um ID=SISCOAFRecibo


concatenado com a data do dia que est enviado a
solicitao no formato ddmmaaaa. Esta tag ser a
tag utilizada para assinatura do arquivo.
Ex: SISCOAFRecibo06072009

A02

1-1

CNPJ do comunicante

A02

1-1

Data do envio das comunicaes que o usurio


deseja

A01

3.1.1 Exemplo xml de solicitao de recibo:


<?xml version='1.0' encoding='iso-8859-1'?>
<LOTERECIBO>
<OCORRENCIAS ID="SISCOAFRecibo07062009">
<CPFCNPJCom>12345678000101</CPFCNPJCom>
<DATA>06/06/2009</DATA>
</OCORRENCIAS>
</LOTERECIBO>

3.1.2 Exemplo xml de solicitao com assinatura:


<?xml version='1.0' encoding='iso-8859-1'?>
<LOTERECIBO>
<OCORRENCIAS ID="SISCOAFRecibo01012009">
<CPFCNPJCom>12345678000101</CPFCNPJCom>
<DATA>03/06/2009</DATA>
</OCORRENCIAS>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="#SISCOAFRecibo01012009">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<DigestValue>hli0xeO7xxgxm90t5UaAH9ZR4w0=</DigestValue>

18

</Reference>
</SignedInfo>
<SignatureValue>Q/XhXmqbs... ...XhXmqbsAz3SutzfNIAvN+k=</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFCTCCA/ ...w4wB0HCY6auKAucqMpi7nPWoVdHDX4bj</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>

</LOTERECIBO>

3.2

Resposta solicitao de recibo

Campo

Pai

Ocor.

A01 RESPOSTA

Raiz

1-1

A02

A01

MENSAGENS

A03 MENSAGEM

Regras e Informaes Associadas

1-1

A02

1-500

Poder haver at 500 mensagens em um arquivo

A03

1-1

Indica o nmero de controle da comunicao pelo


comunicante que a enviou

A05 NUMEROCOAF

A03

1-1

Nmero gerado no COAF para a comunicao

A06 AUTENTICACAO

A03

1-1

Hash gerado para controle

A07 VALOR

A03

1-1

Valor principal da comunicao.

A08

A03

1-1

Status da comunicao no sistema SISCOAF

A04

NUMEROORIGEM

Valores possveis:
Status

- Ativo
- Cancelada
Tag utilizada somente para indicar se uma
comunicao foi cancelada.

19

3.2.1 Exemplo recibo xml:


<?xml version='1.0' encoding='iso-8859-1'?>
<RESPOSTA>
<MENSAGENS><MENSAGEM><NUMEROORIGEM>41792</NUMEROORIGEM>
<NUMEROCOAF>9661556</NUMEROCOAF>
<AUTENTICACAO>78c9c00bcc9e0702e36316528aa56d1d</AUTENTICACAO>
<VALOR>1588417</VALOR>
<STATUS>Ativa</STATUS>
</MENSAGEM>
</MENSAGENS>
</RESPOSTA>
Anexo:
http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-Recibo.xml

20

Cancelamento de comunicaes
O cancelamento de comunicaes ser executado on-line.
O Cancelamento de comunicaes s ser possvel aps o processamento da mesma na base, assim no
ser possvel cancelar uma comunicao que acabou de ser enviada, pois a mesma s estar disponvel no
dia seguinte. Para utilizao com webservice o arquivo xml dever ser assinado com certificado na tag
Ocorrncias.
Webservice Tag a ser assinada por certificado digital: <OCORRENCIAS>

4.1

Formato cancelamento

Campo

A01 LOTECANCELAMENTO

Pai

Ocor.

Raiz

1-1

A01

1-1

A02
OCORRENCIAS

Regras e Informaes Associadas

Dever conter o ID:SISCOAFCancelamento + data


(ddmmaaaa)

Ex: SISCOAFCancelamento01012009
A03

OCORRENCIA

A02

1-100

A04

Poder haver at 100 cancelamentos em um arquivo

A03

1-1

Indica o nmero de controle da ocorrncia pelo


comunicante que a enviou

A05 NUMEROCOAF

A03

1-1

Nmero da comunicao gerada no COAF

A06 AUTENTICACAO

A03

1-1

Cdigo de autenticao gerado pelo COAF no envio

NUMEROORIGEM

4.1.1 Exemplo cancelamento xml:


<?xml version='1.0' encoding='iso-8859-1'?>
<LOTECANCELAMENTO>
<OCORRENCIAS ID='SISCOAFCancelamento05072013'>
<OCORRENCIA>
<NUMEROORIGEM>15</NUMEROORIGEM>
<NUMEROCOAF>926767</NUMEROCOAF>
<AUTENTICACAO>85edce8b2118f0a21a2f743916daaa91</AUTENTICACAO>
</OCORRENCIA>
</OCORRENCIAS>
</LOTECANCELAMENTO>
Anexo:
http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-TesteCancelamento.xml

21

4.1.2 Exemplo cancelamento xml com assinatura:


<?xml version='1.0' encoding='iso-8859-1'?>
<LOTECANCELAMENTO>
<OCORRENCIAS ID='SISCOAFCancelamento05072013'>
<OCORRENCIA>
<NUMEROORIGEM>15</NUMEROORIGEM>
<NUMEROCOAF>926767</NUMEROCOAF>
<AUTENTICACAO>85edce8b2118f0a21a2f743916daaa91</AUTENTICACAO>
</OCORRENCIA>
</OCORRENCIAS>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="#SISCOAFCancelamento01012009">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<DigestValue>hli0xeO7xxgxm90t5UaAH9ZR4w0=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>Q/XhXmqbs... ...XhXmqbsAz3SutzfNIAvN+k=</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFCTCCA/ ...w4wB0HCY6auKAucqMpi7nPWoVdHDX4bj</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>

</LOTECANCELAMENTO>

22

4.2

Resposta do cancelamento
Aps o envio da comunicao a mesma ser validada e ser enviado imediatamente um retorno ao
comunicante, disponvel em tela e gerao de arquivo xml, indicando se o envio foi bem sucedido, e em caso
de problemas na validao ser informado o problema encontrado em cada ocorrncia.

4.2.1 Formato resposta cancelamento


Aps o envio da comunicao a mesma ser validada e ser enviado um retorno ao comunicante, indicando
se o envio foi bem sucedido em caso de problemas na validao ser informado o problema encontrado em
cada ocorrncia.
#

Campo

A01 RESPOSTA

Pai

Ocor.

Raiz

1-1

A02
STATUS

A03

MENSAGENS

A01

A01

A04

1-1

A03

1-500

COMUNICACAOORIGEM

A04

1-1

A04

1-1

A06

Valores possveis: 1 e 2
1: No foi encontrado problema no cancelamento de
nenhuma comunicao
2: Problemas foram encontrados no cancelamento de
pelo menos uma comunicao

1-1

MENSAGEM
A05

Regras e Informaes Associadas

ERRO

Poder haver at 500 mensagens em um arquivo de


resposta
Indica o nmero de controle da ocorrncia pelo
comunicante que a enviou
Cdigo do erro encontrado na ocorrncia ou cdigo
informando que a comunicao foi cancelada com
sucesso

4.2.2 Exemplo resposta cancelamento xml:


<?xml version='1.0' encoding='iso-8859-1'?>
<RESPOSTA>
<STATUS>2</STATUS>
<MENSAGENS>
<MENSAGEM>
<COMUNICACAOORIGEM>2</COMUNICACAOORIGEM>
<ERRO>11</ERRO>
</MENSAGEM>
<MENSAGEM>
<COMUNICACAOORIGEM>12</COMUNICACAOORIGEM>
<ERRO>3</ERRO>
</MENSAGEM>
</MENSAGENS>
</RESPOSTA>

23

Retificao de comunicaes
A retificao ser executa on-line
A retificao de comunicaes s ser possvel aps o processamento da mesma na base, assim no ser
possvel retificar uma comunicao que acabou de ser enviada, pois a mesma s estar disponvel no dia
seguinte. Para utilizao com webservice o arquivo xml dever ser assinado com certificado na tag
Ocorrncias.
Na retificao todos os dados da comunicao devero ser informados novamente e ser gerado um novo
nmero no SISCOAF. O retorno do envio de um lote de retificao ser o mesmo de um lote normal.
Webservice Tag a ser assinada por certificado digital: <OCORRENCIAS>

5.1

Formato retificao

Campo

A00 LOTERETIFICACAO
A01
A02

Pai

Ocor.

Regras e Informaes Associadas

Raiz

1-1

OCORRENCIAS

A00

1-1

Dever conter o ID:SISCOAF + data


Ex: SISCOAF01012009

OCORRENCIA

A01

1-500

Poder haver at 500 ocorrncias em um


arquivo xml

1-1

Identificador da comunicao na origem. Tratase de um nmero gerado e controlado pela


prpria pessoa obrigada. Este utilizado no
COAF para controle e restrio de envio de
informao duplicada.

1-1

Nmero da comunicao gerada no SISCOAF

A03
NumOcorrencia

A04 NumeroCOAF

A02

A02

A05
CPFCNPJCom

A06 DtInicio

CPF ou CNPJ da pessoa fsica ou jurdica que


est comunicando o fato comunicado. Devero
ser informados apenas nmeros com 11
dgitos para CPF e 14 para CNPJ,
completando com 0 esquerda caso
necessrio.

A02

A02

1-1

Indica data inicial do fato comunicado

A02

1-1

Indica data final do fato comunicado. Para fato


ocorrido em dia especfico, deve ser informado
o mesmo valor do campo data inicial.

A02

1-1

A07
DtFim

A08

AgNum

Para o segmento DPF Transporte e Guarda


de valores este campo dever ser preenchido
com a informao:
- Cidade/UF Destino
Para os demais segmentos abaixo no dever
ser preenchido:

A09 AgNome

A02

1-1

Este campo no necessita de preenchimento.

24

#
A10
A11

Campo
AgMun
AgUF

Pai

Ocor.

A02

1-1

Nome do municpio em que o fato comunicado


ocorreu.

A02

1-1

Unidade da Federao em que se localiza o


municpio em que o fato comunicado ocorreu

A02

1-1

A12
Det

Regras e Informaes Associadas

Descrio detalhada da anlise feita pela


instituio financeira a respeito do fato
comunicado

25

Campo

Pai

A13

Ocor.
1-1

VlCred

A02

Regras e Informaes Associadas


Este campo equivaler seguinte informao
de acordo com o segmento
Bens de alto valor de origem rural ou
animal
Valor total
COAF - Bens de luxo ou de alto valor
Valor total
COAF - Bingos
Valor da premiao
COAF - Bolsas de mercadorias
Valor do(s) pagamento(s)
COAF - Cartes de crdito
Valor da ocorrncia
COAF Factoring e securitizao de
ativos, ttulos ou recebveis mobilirios
Valor da operao ou dos ativos vendidos
COAF - Jias, pedras e metais preciosos
Valor da operao ou proposta
COAF - Loterias e Sorteios
Valor do Prmio
COAF - Objetos de arte e antiguidades
Valor da operao
COAF - Remessas Alternativas de
Recursos
Valor da(s) Transao(es) Nacional(is)
COAF - Servios de assessoria,
consultoria, auditoria, aconselhamento ou
assistncia
Valor total
COFECI - Promoo imobiliria
compra/venda imveis
Valor do Imvel objeto da operao
CVM - Mercado de Valores Mobilirios
Valor
DPF - Transporte e Guarda de Valores
Valor Transportado
Feiras, exposies e similares
Valor
Outros rgos - Servios de assessoria,
consultoria, contadoria, auditoria,
aconselhamento ou assistncia
Valor
Outros setores previstos na Lei n
9.613/1998
Valor total
PREVIC - Previdncia Complementar
Valor da Operao/Contribuio
Registros pblicos
Valor
Transferncia de atletas e artistas
Valor

26

Campo

A14

Pai
A02

Ocor.
1-1

VlDeb

Regras e Informaes Associadas


Este campo equivaler seguinte informao
de acordo com o segmento
Bens de alto valor de origem rural ou
animal
Valor pago em espcie
COAF - Bens de luxo ou de alto valor
Valor pago em espcie
COAF - Bingos
Valor da aposta ou arrecadao
COAF Factoring e securitizao de
ativos, ttulos ou recebveis mobilirios
Valor pago em espcie
COAF - Jias, pedras e metais preciosos
Valor do(s) pagamento(s) em espcie
COAF - Loterias e Sorteios
Valor da(s) aposta(s) ou arrecadao
COAF - Objetos de arte e antiguidades
Valor da(s) aposta(s) ou arrecadao
COAF - Remessas Alternativas de
Recursos
Valor da(s) Transao(es) Internacional(is)
COAF - Servios de assessoria,
consultoria, auditoria, aconselhamento ou
assistncia
Valor pago em espcie
COFECI - Promoo imobiliria
compra/venda imveis
Valor da transao/operao
DPF - Transporte e Guarda de Valores
Valor Guardado/Custodiado
Outros setores previstos na Lei n
9.613/1998
Valor pago em espcie

Os segmentos no listados devero preencher


este campo com 0(zero)
A15

A02

1-1

VlProv

Este campo equivaler seguinte informao


de acordo com o segmento
COAF - Loterias e Sorteios
Quantidade de premiaes
DPF - Transporte e Guarda de Valores
Proposta

Os demais segmentos devero preencher este


campo com 0(zero)
A16

A02

1-1

COAF - Loterias e Sorteios


Valor Pago em espcie

VlProp
Este campo dever ser preenchido com
0(zero) para os demais segmentos
A17 ENQUADRAMENTOS

A02

1-1

27

Campo

Pai

Ocor.

A18
CodEnq

A19 ENVOLVIDOS
A20

ENVOLVIDO

A16

1-10

A02

1-1

A18

1-50

A21

CPFCNPJEnv

A19

1-1

Regras e Informaes Associadas


Cdigo identificador do tipo de
ocorrncia/enquadramento do fato comunicado
Poder haver at 10 cdigos de
enquadramento para cada ocorrncia

Poder haver at 50 envolvidos em cada


ocorrncia
CPF ou CNPJ da pessoa fsica ou jurdica
envolvida no fato comunicado. Devero ser
informados apenas nmeros com 11 dgitos
para CPF e 14 para CNPJ, completando com 0
esquerda caso necessrio.
Ex:
<CPFCNPJEnv>00012345602</CPFCNPJEnv>
<CPFCNPJEnv>00001234000145</CPFCNPJEnv
>

Caso no tenha a informao de CPF ou


CNPJ informar somente o tipo da pessoa com
PF ou PJ no campo correspondente Ex:
<CPFCNPJEnv>PF</CPFCNPJEnv>
<CPFCNPJEnv>PJ</CPFCNPJEnv>
A22
A23

NmEnv
TpEnv

A19
A19

1-1

Nome da pessoa fsica ou jurdica envolvida no


fato comunicado

1-1

Tipo de envolvimento, cdigo de acordo com


tabela de tipo de envolvimento.

A24 AgNumEnv

A19

1-1

No ser preenchido

A25 AgNomeEnv

A19

1-1

No ser preenchido

A26 NumConta

A19

1-1

No ser preenchido

A27 DtAbConta

A19

1-1

No ser preenchido

A28 DtAtuaCad

A19

1-1

No ser preenchido

1-1

Indica se o envolvido pessoa obrigada no


mbito da Lei n 9.613
0 No Pessoa Obrigada/No possui
informao
1 Pessoa Obrigada

1-1

Indica se o envolvido pessoa politicamente


exposta
0 No PEP/No possui informao
1 PEP

A19
A29 PObrigada

A19
A30 PEP

28

Campo

Pai

Ocor.

A19

A31 ServPub

1-1

Regras e Informaes Associadas


Indica se o envolvido servidor pblico. 5
opes:
0 No servidor/No possui informao
1 - Serv Pblico
2 SPF (Serv. Publ. Federal)
3 SPE (Serv. Publ. Estadual)
4 SPM (Serv. Publ. Municipal)
Obs: as opes 2, 3 e 4 devero ser utilizadas
caso esteja disponvel a classificao do
servidor pblico, caso contrrio poder ser
informado somente o cdigo 1.

5.1.1 Exemplo retificao rea de dados


Anexo:
http://www1.fazenda.gov.br/siscoaf/portugues/publicacoes/SISCOAF-TesteRetificacaoGeral.xml

5.1.2 Exemplo retificao com assinatura


<?xml version='1.0' encoding='iso-8859-1'?>
<LOTERETIFICACAO>
<OCORRENCIAS ID="SISCOAF03052009">
<OCORRENCIA>
<NumOcorrencia>1</NumOcorrencia>
<NumeroCOAF>8284036</NumeroCOAF>
<CPFCNPJCom>33683111000107</CPFCNPJCom>
<DtInicio>01/01/2009</DtInicio>
<DtFim>01/01/2009</DtFim>
<AgNum></AgNum>
<AgNome></AgNome>
<AgMun>BRASILIA</AgMun>
<AgUF>DF</AgUF>
<Det>Detalhar a operao neste campo</Det>
<VlCred>150000</VlCred>
<VlDeb>0</VlDeb>
<VlProv>0</VlProv>
<VlProp>0</VlProp>
<ENQUADRAMENTOS>
<CodEnq>653</CodEnq>
</ENQUADRAMENTOS>
<ENVOLVIDOS>
<ENVOLVIDO>
<CPFCNPJEnv>56283456321</CPFCNPJEnv>
<NmEnv>MANOEL VALDOIS</NmEnv>
<TpEnv>1</TpEnv>
<AgNumEnv></AgNumEnv>
<AgNomeEnv></AgNomeEnv>
<NumConta></NumConta>
<DtAbConta></DtAbConta>
<DtAtuaCad></DtAtuaCad>
<PObrigada>0</PObrigada>

29

<PEP>0</PEP>
<ServPub>0</ServPub>
</ENVOLVIDO>
<ENVOLVIDO>
<CPFCNPJEnv>34567891000112</CPFCNPJEnv>
<NmEnv>Comercial Teste Ltda</NmEnv>
<TpEnv>2</TpEnv >
<AgNumEnv></AgNumEnv>
<AgNomeEnv></AgNomeEnv>
<NumConta></NumConta>
<DtAbConta></DtAbConta>
<DtAtuaCad></DtAtuaCad>
<PObrigada>0</PObrigada>
<PEP>1</PEP>
<ServPub>2</ServPub>
</ENVOLVIDO>
</ENVOLVIDOS>
</OCORRENCIA>
</OCORRENCIAS>
<Signature xmlns="http://www.w3.org/2000/09/xmldsig#">
<SignedInfo>
<CanonicalizationMethod Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315"/>
<SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1" />
<Reference URI="# SISCOAFRetificacao03052009">
<Transforms>
<Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature" />
<Transform Algorithm="http://www.w3.org/TR/2001/REC-xml-c14n-20010315" />
</Transforms>
<DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1" />
<DigestValue>hli0xeO7xxgxm90t5UaAH9ZR4w0=</DigestValue>
</Reference>
</SignedInfo>
<SignatureValue>Q/XhXmqbs... ...XhXmqbsAz3SutzfNIAvN+k=</SignatureValue>
<KeyInfo>
<X509Data>
<X509Certificate>MIIFCTCCA/ ...w4wB0HCY6auKAucqMpi7nPWoVdHDX4bj</X509Certificate>
</X509Data>
</KeyInfo>
</Signature>
</LOTERETIFICACAO>

30

You might also like