Documentação
Endpoints
Endereço de autenticação
| Ambiente |
URL |
| Homologação |
https://auth-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-autenticacao/token |
| Produção |
https://auth-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-autenticacao/token |
Para mais detalhes sobre a autenticação, consulte a seção Autenticação na API.
Endpoints de acesso ao serviço
URL Base por ambiente:
-
Ambiente de Homologação:
https://auth-h-sigap-rec.df-1.estaleiro.serpro.gov.br/
-
Ambiente de Produção:
https://auth-sigap-rec.ni.estaleiro.serpro.gov.br/
Operações:
Operação para envio de lotes de apostas
Recepção de lote diário e detalhado de apostas
[POST] /recepcao-aposta/aposta-esportiva/lote
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-aposta/aposta-esportiva/lote |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-aposta/aposta-esportiva/lote |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteApostaEsportivaXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Operação para envio de lotes de apostadores
Recepção de lote diário e detalhado de apostadores
[POST] /recepcao-apostador/apostador/lote
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-apostador/apostador/lote |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-apostador/apostador/lote |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteApostadorXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Operação para envio de lotes de carteiras
Recepção de lote diário e detalhado de carteiras
[POST] /recepcao-carteira/carteira/lote
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-carteira/carteira/lote |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-carteira/carteira/lote |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteCarteiraXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Operações para envio de lotes de operadores
Recepção de lote diário e detalhado de operadores
[POST] /recepcao-operador/operador/lote/diario
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-operador/operador/lote/diario |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-operador/operador/lote/diario |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteOperadorXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Recepção de lote mensal e detalhado de operadores
[POST] /recepcao-operador/operador/lote/mensal
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-operador/operador/lote/mensal |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-operador/operador/lote/mensal |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteOperadorMensalXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Operação para envio de lotes de jogos online
Recepção de lote diário e detalhado de jogos online
[POST] /recepcao-jogo/jogo-online/lote
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/recepcao-jogo/jogo-online/lote |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/recepcao-jogo/jogo-online/lote |
Entrada
| Parâmetro |
Tipo |
Descrição |
| LoteJogoOnlineXmlGZipB64 |
string |
Arquivo XML com lote compactado em Gzip base64binary |
Operação para recuperação do status de envio realizado pela operadora
Retorno do status do movimento de lote enviado
Endpoints
| Ambiente |
URL |
| Homologação |
https://api-h-sigap-rec.df-1.estaleiro.serpro.gov.br/movimento/search |
| Produção |
https://api-sigap-rec.ni.estaleiro.serpro.gov.br/movimento/search |
Entrada
| Parâmetro |
Tipo |
Descrição |
| cnpj |
string |
CNPJ sem formatação (ex.: "33683111000107") |
| marca |
string |
Marca |
| dataReferenciaInicio |
string |
Data inicial dos lotes no formato "YYYY-MM-DD" (ex.: "2025-10-01") |
| dataReferenciaFim |
string |
Data final dos lotes no formato "YYYY-MM-DD" (ex.: "2025-10-31") |
Saída
| Parâmetro |
Tipo |
Descrição |
| cnpj |
string |
CNPJ sem formatação (ex.: "33683111000107") |
| marca |
string |
Marca |
| dataReferencia |
string |
Data referência do lote (ex.: "2025-10-01") |
| situacao |
string |
"NAO_PROCESSADO", "PROCESSADO_PENDENCIA", "PROCESSADO_SUCESSO", "AGUARDANDO_PROCESSAMENTO_CORRECAO", "AGUARDANDO_PROCESSAMENTO_RETIFICACAO" |
| dataProcessamento |
string |
Data do processamento do movimento (ex.: "2025-10-01") |
| mensagens |
array |
array com pares de código e descrição |
Códigos de Retorno
As requisições à API Sigap podem receber como retorno os seguintes código HTTP:
Code / Responses
200 (Ok)
Requisição recebida e processada com sucesso, no caso dos endpoints que não envolvem envio de arquivos.
201 (Created)
Tudo funcionou como esperado, no caso de envio de arquivo.
250 Falha na validação do esquema XML do lote
A requisição não foi aceita pois existe alguma inconsistência entre o arquivo xml enviado e a validação com o esquema xsd do tipo de arquivo enviado.
400 Requisição inválida
A requisição não foi aceita pois existe alguma inconsistência em algum parâmetro. Uma mensagem especificando o tipo de erro será retornado no corpo da resposta.
401 Usuário não autorizado (Unauthorized)
Problemas durante a autenticação/autorização.
404 Recurso não encontrado (Not Found)
A requisição referenciou um endpoint não existente ou para o qual não há dados.
413 Tamanho máximo do arquivo excedido
Tamanho máximo do arquivo permitido 3mb.
500 Erro interno na aplicação (Internal Server Error)
Ocorreu algum erro interno no Servidor.