Documente Academic
Documente Profesional
Documente Cultură
Manual Tcnico
Verso 1.1.3
Sumrio
Captulo I Estrutura de Dados e Transmisso .............................................................................. 2
Introduo ................................................................................................................................. 3
Servios Disponveis .................................................................................................................. 4
Segurana .................................................................................................................................. 5
Procedimento ............................................................................................................................ 6
Tipos de Dados Simples ............................................................................................................. 8
Formato de Especificao das Entidades .................................................................................. 9
Entidades ................................................................................................................................. 10
Cdigos Genricos de Obras Audiovisuais .............................................................................. 16
Formato de Entrada e Sada das Operaes ........................................................................... 17
Captulo II Certificao dos Sistemas de Transmisso .............................................................. 35
Introduo ............................................................................................................................... 36
Ambientes .............................................................................................................................. 37
Tokens .................................................................................................................................... 38
Procedimento de Certificao ................................................................................................. 39
Arquitetura da Soluo ........................................................................................................... 40
Tutorial .................................................................................................................................... 41
Captulo III Perguntas Frequentes ............................................................................................. 45
Estrutura de Dados e Transmisso ......................................................................................... 46
Certificao dos Sistemas ....................................................................................................... 48
Outros ..................................................................................................................................... 49
Captulo IV Anexos ..................................................................................................................... 50
Anexo I Mensagens das Operaes ...................................................................................... 51
Anexo II - Categorias de Ingressos .......................................................................................... 53
Anexo III - Modalidades de Pagamentos ................................................................................ 54
Captulo I
Estrutura de Dados e Transmisso
1. Introduo
Este captulo do manual tem como objetivo apresentar a estrutura dos dados de bilheteria
definida para a utilizao do Sistema de Controle de Bilheteria (SCB), disponibilizado na forma
de web service pela Agncia Nacional do Cinema - ANCINE.
Atravs deste web service, os exibidores de obras audiovisuais atuantes no segmento de salas
de exibio podero integrar seus prprios sistemas de informao com o SCB para
cumprimento do disposto na Instruo Normativa 123, que regulamenta o envio de informaes
para este sistema, bem como, para consultas relacionadas.
O web service SCB segue o padro REST (REpresentational State Transfer) e pode ser utilizado
trafegando mensagens nos formatos XML ou JSON, amplamente utilizados pelo mercado. Sendo
determinado o UTF-8 como o padro de codificao de caracteres do corpo das requisies.
Sobre a metodologia do versionamento do manual, o primeiro dgito corresponde a mudanas
na Instruo Normativa que venham a impactar o web service. O segundo dgito ser
incrementado quando houver mudanas na interface do SCB como, por exemplo, a incluso de
novas entidades ou atributos. Essas mudanas necessariamente demandam alterao no
sistema do regulado ou criao de um novo servio dentro do SCB. O terceiro dgito corresponde
a mudanas meramente textuais, isto , a incluso, modificao ou excluso de mensagens de
erro ou alerta como, por exemplo, uma mudana na mensagem de ERRO para ALERTA e viceversa.
2. Servios Disponveis
As seguintes operaes/servios esto disponveis no web service do Sistema de Controle de
Bilheteria:
3. Segurn
3.1
Autenticao
A autenticao dos sistemas de informao dos exibidores no web service realizada via Basic
Authentication, que consiste na incluso de um cabealho HTTP com a chave/identificador
Authorization e seu valor ser um token de autenticao a ser gerado atravs de tela especfica
dentro do SAD Sistema ANCINE Digital.
Uma requisio HTTP completa para o web service do SCB dever conter os headers semelhantes
ao exemplo abaixo:
POST /scb/v1.0/bilheterias HTTP/1.1
Authorization: QWxhZGRpbjpvcGVuIHNlc2FtZQ
Content-Type: application/json
3.2
Trfego Seguro
4. Procedimento
Conforme definido na Instruo Normativa que regulamenta o envio de informaes ao Sistema
de Controle de Bilheteria (SCB), o envio de relatrios dirio. A granularidade das mensagens
de requisio ao web service SCB, conforme ser detalhado nas prximas sees deste manual,
definida por: sala e dia cinematogrfico. Ou seja, ser feita uma chamada ao web service com
os dados de todas as sesses cinematogrficas de um determinado dia cinematogrfico para
cada uma das salas do exibidor.
Por exemplo, se determinado exibidor possui dez salas de exibio cinematogrfica e ele
pretende enviar os dados de bilheteria de um nico dia, sero realizadas dez chamadas ao
web service SCB, sendo que cada requisio conter os dados de bilheteria de todas as sesses
realizadas no respectivo dia cinematogrfico e na respectiva sala.
Cada uma das chamadas ao web service SCB, quando enviados no formato especificado neste
manual e com o contedo semanticamente correto, retornar o cdigo HTTP 201 e, no corpo da
resposta, uma estrutura de dados na qual estar contido um nmero de protocolo sob o status
Em anlise. Caso o formato esteja conforme o especificado mas o contedo esteja
semanticamente incorreto, ser retornado o cdigo HTTP 422 e, no corpo da resposta, uma
estrutura de dados similar sob o status No acatado mas sem um nmero de protocolo.
Contudo, caso os dados sejam enviados em formato ou condies divergentes deste manual,
ser retornado o cdigo HTTP 400 com uma mensagem de texto indicando o erro no corpo da
resposta.
O fluxo acima descrito pode ser visualizado no diagrama abaixo:
Agncia, entretanto, sem que haja anlise do contedo. A anlise e validao dos dados sero
realizadas posteriormente ao envio do protocolo. Portanto, o sistema de informao do
exibidor dever, aps alguns minutos, fazer requisies a uma segunda operao do web
service SCB para realizar o acompanhamento do status final de seu protocolo e o recebimento
de notificaes de erros ou alertas em relao aos dados enviados.
Vale ressaltar que a anlise dos dados enviados ser realizada individualmente. Assim, como
cada protocolo se refere s sesses de uma sala num dado dia cinematogrfico, na hiptese de
o exibidor realizar dezenas de envios e apenas um dos protocolos apresentar erros, ser
necessrio reenviar somente as sesses daquela sala e dia cinematogrfico.
Podero ocorrer situaes em que parte dos protocolos enviados j passou pelo processo de
anlise e validao e parte ainda no. Neste caso, o loop demonstrado no diagrama abaixo seria
repetido apenas para os protocolos que ainda esto Em anlise:
Data Hora
Inteiro[min-max]
Decimal
Texto[min-max]
Booleano
Nome do Atributo
(3)
Tipo
(4)
Ocorrncia
(5)
(1)
(2)
Descrio
(6)
1. Nome da entidade;
2. Descrio da entidade;
3. Nome do atributo que faz parte da entidade;
4. Tipo do atributo, que pode ser de um tipo simples ou uma entidade;
5. Quantas vezes o campo se repete na estrutura de dados seguindo o formato x-y, onde x a quantidade mnima e y a quantidade mxima. Se
a quantidade mxima for indefinida, ser utilizado N no lugar do y;
6. Descrio do campo.
7. Entiddes
Nesta seo esto descritas cada uma das entidades utilizadas nas trocas de mensagens com o web service do Sistema de Controle de Bilheteria SCB no
processo de transmisso de dados de bilheteria e suas respectivas respostas no formato tabular descrito na seo anterior.
7.1
10
7.2
Bilheteria
Representa os dados de bilheteria de todas as sesses cinematogrficas realizadas por um exibidor em uma determinada sala de exibio para um dia
cinematogrfico especfico
Nome do Atributo
Tipo
Ocorrncia Descrio
registroANCINEExibidor
Inteiro[1-7]
1-1
Nmero do registro do agente econmico perante ANCINE.
registroANCINESala
Inteiro[1-7]
1-1
Nmero do registro da Sala de Exibio perante ANCINE. S possui registro aquela sala de
exibio que possui o cadastro deferido.
diaCinematografico
Data
1-1
Dia, ms e ano correspondentes ao dia de exibio cujas informaes esto sendo
enviadas.
houveSessoes
Booleano
1-1
Indica se houve ou no sesses na sala de exibio e no dia cinematogrfico. Caso no
tenha havido, deve ser preenchido com N e a lista de sesses do prximo campo ser
enviada vazia.
retificador
Booleano
1-1
Indica se o envio corresponde a uma retificao do ltimo relatrio de bilheteria enviado
para o dia cinematogrfico e sala de exibio. Caso seja uma retificao, deve ser
preenchido com S, caso seja um envio original deve ser preenchido com N.
sessoes
Sessao
0-N
Lista das sesses cinematogrficas realizadas na sala de exibio e dia cinematogrfico
reportado.
Sessao
Representa uma sesso cinematogrfica
Nome do Atributo
Tipo
dataHoraInicio
Data Hora
modalidade
Texto[1-1]
Ocorrncia
1-1
1-1
vendedorRemoto
VendedorRemoto
0-1
obras
Obra
1-N
totalizacoesTipoAssento
TotalizacaoTipoAssento
2-2
Descrio
Data e Hora do incio da sesso (horrio local)
Cdigo que especifica a modalidade da sesso cinematogrfica. Sendo:
A Sesso Regular
B Pr-estreia
C Sesso de Mostra ou Festival D Sesso Privada
Principal prestador do servio de venda remota de bilhetes de ingresso
da respectiva sesso, se houver.
Obras audiovisuais que foram exibidas na respectiva sesso
cinematogrfica e as caractersticas da projeo realizada
Lista de totalizaes da quantidade de assentos disponibilizados para a
respectiva sesso cinematogrfica de acordo com o tipo de assento
(Padro ou Especial).
11
VendedorRemoto
Representa um prestador de servio de venda remota de bilhetes de ingresso
Nome do Atributo
Tipo
Ocorrncia
cnpj
Inteiro [14-14]
1-1
razaoSocial
Texto[1-100]
1-1
Descrio
CNPJ do prestador do servio
Razo Social do prestador do servio
Obra
Representa uma obra audiovisual exibida em uma sesso cinematogrfica, bem como, um conjunto de caractersticas da projeo realizada
Nome do Atributo
Tipo
Ocorrncia
Descrio
numeroObra
Texto [14-14]
1-1
Cdigo CPB, ROE ou Cdigo Genrico da obra audiovisual
tituloObra
Texto[1-100]
1-1
Ttulo da obra audiovisual no Brasil
tipoTela
Texto [1-1]
1-1
Cdigo que especifica o tipo da tela utilizada na projeo. Sendo:
P Padro
A Ampliada
digital
Booleano
1-1
Indica se a projeo foi realizada atravs de mdias digitais ou no.
tipoProjecao
Inteiro[1-1]
1-1
Cdigo que especifica o tipo de projeo. Sendo:
2 Projeo em 2 dimenses (2D)
3 Projeo em 3 dimenses (3D)
audio
Texto [1-1]
1-1
Indica a forma que o udio da obra foi reproduzido. Sendo:
O Original
D - Dublado
legenda
Booleano
1-1
Indica se houve exibio de legendas na projeo da obra audiovisual
libras
Booleano
1-1
Indica a disponibilidade ou no de traduo da obra audiovisual para a
lngua brasileira de sinais (libras) na projeo da obra
legendagemDescritiva
Booleano
1-1
Indica a disponibilidade ou no de legendagem descritiva (closed
caption) na projeo da obra
audioDescricao
Booleano
1-1
Indica a disponibilidade ou no de audiodescrio (narrao de
elementos sonoros e visuais) na projeo da obra
distribuidor
Distribuidor
1-1
Distribuidor do qual foi adquirida os direitos de exibio da obra
Distribuidor
Representa um distribuidor de obras audiovisuais
Nome do Atributo
Tipo
cnpj
Inteiro [14-14]
razaoSocial
Texto[1-100]
Ocorrncia
1-1
1-1
Descrio
CNPJ do distribuidor
Razo Social do distribuidor
12
TotalizacaoTipoAssento
Representa um sumrio de totalizaes da quantidade de assentos disponibilizados de um determinado tipo de assento (Padro ou Especial)
Nome do Atributo
Tipo
Ocorrncia Descrio
codigoTipoAssento
Texto [1-1]
1-1
Cdigo que especifica o tipo do respectivo assento. Sendo:
P Padro
E Especial
quantidadeDisponibilizada
Inteiro[1-5]
1-1
Quantidade de assentos do respectivo tipo disponveis para a
sesso cinematogrfica na qual o totalizador est contido.
totalizacoesCategoriaIngresso
TotalizacaoCategoriaIngresso
4-4
Lista de totalizaes de quantidade de espectadores por
categoria de ingresso definida no anexo II deste manual.
TotalizacaoCategoriaIngresso
Representa um sumrio de totalizaes da quantidade de espectadores em cada uma das categorias estabelecidas no Anexo II deste manual
Nome do Atributo
Tipo
Ocorrncia Descrio
codigoCategoriaIngresso
Inteiro[1-2]
1-1
Nmero referente categoria que a totalizao se refere. Esse
nmero deve ser um dos previstos na lista de categorias de
ingressos estabelecida no Anexo II deste manual.
quantidadeEspectadores
Inteiro[1-5]
1-1
Nmero de espectadores presentes na sesso com ingressos da
categoria a que se refere essa totalizao.
totalizacoesModalidadePagamento
TotalizacaoModalidadePagamento
3-3
Lista de totalizaes de valores arrecadados por meio de cada
uma das modalidades de pagamento previstas no Anexo III
deste manual.
TotalizacaoModalidadePagamento
Representa um sumrio de totalizaes dos valores arrecadados por meio de cada uma das modalidades de pagamento previstas no Anexo III deste manual
Nome do Atributo
Tipo
Ocorrncia Descrio
codigoModalidadePagamento
Inteiro [1-2]
1-1
Nmero referente modalidade de pagamento que a
totalizao se refere.
valorArrecadado
Decimal
1-1
Valor arrecadado na sesso com a venda de ingressos da
categoria na qual est contido utilizando a modalidade de
pagamento a que se refere essa totalizao.
13
7.3
StatusRelatorioBilheteria
Representa o status do protocolo de envio dos dados de bilheteria de sala de exibio realizado pelo exibidor
Nome do Atributo
Tipo
Ocorrncia Descrio
registroANCINEExibidor
Inteiro[1-7]
1-1
Nmero do registro do agente econmico perante a ANCINE informado na respectiva
operao de Registro de Bilheteria de Sala de Exibio
registroANCINESala
Inteiro[1-7]
1-1
Nmero do registro da Sala de Exibio perante a ANCINE informado na respectiva
operao de Registro de Bilheteria de Sala de Exibio
diaCinematografico
Data
1-1
Dia, ms e ano correspondentes ao dia de exibio informado na respectiva operao de
Registro de Bilheteria de Sala de Exibio.
numeroProtocolo
Texto[22-25]
1-1
Nmero nico de protocolo gerado pela operao de envio dos dados de bilheteria de
Sala de Exibio.
statusProtocolo
Texto [1-1]
1-1
Cdigo que especifica o status do protocolo de envio dos dados de bilheteria de Sala de
Exibio. Sendo:
N No acatado (Os dados no foram acatados por no passarem pela validao inicial
que faz verificaes bsicas como completude e tipo dos dados, no gerando protocolo)
A Em Anlise (Os dados foram enviados obedecendo estrutura especificada neste
manual e est aguardando processamento mais detalhado da consistncia dos dados,
validade de cdigo, etc)
E Com Erro (Os dados enviados foram processados e apresentaram inconsistncias,
incorrees, e devero ser retificados pelo exibidor)
V Validado (Os dados enviados foram processados com sucesso e acatados pela
ANCINE)
R Recusado (Durante auditoria dos dados enviados e em princpio validados, foram
encontrados indcios de irregularidades, tornando-se uma situao de inadimplncia)
mensagens
Mensagem
0-N
Mensagens relacionadas ao processamento do Registro de Bilheteria
Mensagem
Representa uma mensagem de informao, erro ou alerta em resposta a uma operao do web service executada pelo exibidor
Nome do Atributo
Tipo
Ocorrncia Descrio
tipoMensagem
Texto [1-1]
1-1
Cdigo que especifica o tipo da mensagem. Sendo: I - Informativa; A - Alerta; E - Erro
codigoMensagem
Texto [4-4]
1-1
Nmero identificador da ocorrncia correspondente aos cdigos existentes no Anexo I
deste manual.
dataHoraInicio
Data Hora
0-1
Data e Hora do incio da sesso a qual se refere a mensagem, caso seja uma mensagem
referente a uma sesso cinematogrfica especfica.
textoMensagem
Texto[1-N]
1-1
Texto da mensagem para leitura humana.
14
7.4
AdimplenciaExibidor
Representa um relatrio da situao de adimplncia de um exibidor e dia cinematogrfico especfico em relao obrigao determinada pela IN que
estabelece o SCB.
Nome do Atributo
Tipo
Ocorrncia Descrio
registroANCINEExibidor
Inteiro[1-7]
1-1
Nmero do registro do agente econmico perante ANCINE. S possui registro aquele
agente que possui o cadastro deferido.
diaCinematografico
Data
1-1
Dia, ms e ano correspondentes ao dia de exibio para o qual se deseja obter a
situao de adimplncia das salas de exibio do exibidor.
adimplenciaSalas
AdimplenciaSala
1-N
Lista da situao de adimplncia de cada uma das salas do exibidor
AdimplenciaSala
Representa a situao de adimplncia de uma determinada sala de exibio em um dia de exibio especfico em relao obrigao determinada pela IN
que estabelece o SCB. Retorna apenas as salas de exibio situadas em complexos cujo tipo de operao usual seja Comercial e que estejam em
funcionamento ou apenas fechadas temporariamente.
Nome do Atributo
Tipo
Ocorrncia Descrio
registroANCINESala
Inteiro[1-7]
1-1
Nmero do registro da Sala de Exibio perante ANCINE. S possui registro aquela sala de exibio
que possui o cadastro deferido.
situacaoSala
Texto [1-1]
1-1
Cdigo que especifica a situao da sala de exibio no respectivo dia cinematogrfico. Sendo:
N No enviado (Os dados no foram recebidos pelo web service SCB)
E Enviado com erro (Os dados foram recebidos mas seu contedo invlido, devendo portanto ser
enviado novamente com as devidas correes)
R Recusado (Os dados foram recebidos e validados inicialmente, mas foram encontrados indcios de
irregularidades durante auditorias, tornando-se uma situao de inadimplncia)
T Com atraso (Os dados foram recebidos e validados, mas seu envio no obedeceu ao prazo
estabelecido pela norma)
A Em anlise (os dados foram recebidos mas ainda esto sendo analisados)
D Dispensada (A sala de exibio possui uma dispensa de envio concedida pela ANCINE que est em
vigor no dia cinematogrfico solicitado.
F Fechada (Consta no registro da sala de exibio que ela encontrava-se fechada temporariamente
no dia cinematogrfico solicitado, portanto, estava dispensada do envio dos relatrios de bilheteria)
V Adimplente (os dados foram recebidos e validados corretamente)
15
16
Orientaes gerais
Lembrando que o web service SCB segue o padro REST, seguem algumas orientaes gerais que serviro para todas as operaes disponveis:
Autenticao: Considerando-se que servios no guardam estado entre as requisies, todas as requisies aos servios devero vir com o
token de autenticao no cabealho HTTP, ainda que j tenha sido enviado em operaes anteriores.
Autorizao: Antes que um sistema de informao possa efetivamente enviar e receber dados dos servios, necessrio que o exibidor
passe pelo processo de certificao e receba as devidas credenciais conforme captulo II deste manual.
Mtodos HTTP: Um dos princpios do REST refere-se utilizao dos mtodos HTTP em coerncia com a operao que se deseja executar,
sendo assim, quando executar uma operao cujo objetivo seja receber dados do SCB, o mtodo HTTP GET deve ser utilizado na
requisio; da mesma forma, quando executar uma operao cujo objetivo seja enviar dados ao SCB, o mtodo HTTP POST deve ser
utilizado na requisio HTTP.
Cdigos de resposta HTTP: De forma similar ao item anterior, o web service SCB busca utilizar a taxonomia de cdigos de resposta da
requisio originalmente definidas pelo HTTP:
o 2xx = Sucesso: Cdigos de resposta que comecem com 2 significam que a requisio foi realizada com sucesso. Exemplos:
200 - OK: A requisio foi bem sucedida e a resposta est no corpo da mensagem HTTP
201 -Created: A requisio foi aceita para processamento posterior
o 3xx = Redirecionamento: Cdigos de resposta que comecem com 3 indicam que uma ao deve ser tomada pelo cliente para que
a requisio seja atendida. Exemplos
301 Movido: O recurso requisitado foi associado a uma nova URL.
304 No modificado: Se o cliente fez uma requisio condicional e o resultado no se modificou desde a data e hora
informada no cabealho HTTP If-Modified-Since enviado na requisio, o servidor retorna esse cdigo sem dados no corpo
da mensagem (utilizado quando se pretende obter benefcios de cache).
o 4xx = Erro na requisio: Cdigos de resposta que comecem com 4 indicam um possvel erro do cliente da requisio. Exemplos:
400 Requisio ruim: A requisio no pde ser interpretada pelo servidor em razo de erros de formato/sintaxe.
17
9.2
401 No autorizado: A requisio requer autenticao por parte do cliente e as informaes de autenticao no foram
localizadas ou no so vlidas.
403 Proibido: A requisio foi realizada com informaes de autenticao vlidas mas est tentando realizar uma ao ou
acessar um recurso no autorizado para o cliente.
404 No encontrado: O servidor no localizou o recurso solicitado
405 Mtodo no permitido: O mtodo HTTP utilizado no permitido para o recurso identificado na URL
422 - Entidade no processvel: O servidor reconhece que as informaes esto na sintaxe correta, mas seu contedo est
semanticamente incorreto.
5xx = Erro no servidor: Cdigos de resposta que comecem com 5 indicam um erro ocorreu no servidor ou que no est apto a
responder no momento. Exemplos:
501 Erro interno no servidor: O servidor encontrou uma condio inesperada que o impediu de atender a requisio.
503 Servidor indisponvel: O servidor est impossibilitado de tratar a requisio em razo de sobrecarga ou manuteno.
Esta a operao principal para o cumprimento da obrigao estipulada pela Instruo Normativa 123. Atravs dela os exibidores realizaro o envio
dos dados de bilheteria e recebero um nmero de protocolo que confirma este envio1. A execuo desta operao realizada atravs de uma requisio
HTTP com os seguintes parmetros:
URL: https://scb.ancine.gov.br/scb/v1.0/bilheterias
Mtodo HTTP: POST
9.2.1 Dados de Entrada
A operao de registro de bilheteria espera receber os dados de todas as sesses cinematogrficas de um dia cinematogrfico realizadas em uma sala
de exibio. Portanto, os dados de entrada dessa operao, e que devero constar no corpo da requisio HTTP, corresponder a uma instncia do tipo
Bilheteria descrita na seo anterior. Abaixo seguem exemplos do corpo da requisio HTTP para essa operao:
A confirmao do envio dos dados de bilheteria no atesta a correo dos mesmos nem desobriga os exibidores do acompanhamento do status da anlise dos dados
enviados para correo de eventuais inconsistncias
18
XML
<?xml version="1.0" encoding="UTF-8"?>
<Bilheteria>
<registroANCINEExibidor>123456</registroANCINEExibidor>
<registroANCINESala>2456</registroANCINESala>
<diaCinematografico>2014-08-15</diaCinematografico>
<houveSessoes>S</houveSessoes>
<retificador>N</retificador>
<sessoes>
<sessao>
<dataHoraInicio>2014-08-15 09:23:00</dataHoraInicio>
<modalidade>A</modalidade>
<vendedorRemoto>
<cnpj>39285531000103</cnpj>
<razaoSocial>BILHETERIA EVENTOS S/A</razaoSocial>
</vendedorRemoto>
<obras>
<obra>
<numeroObra>B8765783654124</numeroObra>
<tituloObra>DOM CARLOTO</tituloObra>
<tipoTela>A</tipoTela>
<digital>S</digital>
<tipoProjecao>2</tipoProjecao>
<audio>O</audio>
<legenda>N</legenda>
<libras>N</libras>
<legendagemDescritiva>S</legendagemDescritiva>
<audioDescricao>N</audioDescricao>
<distribuidor>
<cnpj>02000879000105</cnpj>
<razaoSocial>CINEFILMES DISTRIBUIDORA LTDA</razaoSocial>
</distribuidor>
</obra>
</obras>
<totalizacoesTipoAssento>
<totalizacaoTipoAssento>
<codigoTipoAssento>P</codigoTipoAssento>
<quantidadeDisponibilizada>300</quantidadeDisponibilizada>
<totalizacoesCategoriaIngresso>
<totalizacaoCategoriaIngresso>
19
<codigoCategoriaIngresso>01</codigoCategoriaIngresso>
<quantidadeEspectadores>30</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>500.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>100.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>02</codigoCategoriaIngresso>
<quantidadeEspectadores>130</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>1000.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>200.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>100.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>03</codigoCategoriaIngresso>
<quantidadeEspectadores>15</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
20
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>04</codigoCategoriaIngresso>
<quantidadeEspectadores>50</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>300.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>150.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>50.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
</totalizacoesCategoriaIngresso>
</totalizacaoTipoAssento>
<totalizacaoTipoAssento>
<codigoTipoAssento>E</codigoTipoAssento>
<quantidadeDisponibilizada>30</quantidadeDisponibilizada>
<totalizacoesCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>01</codigoCategoriaIngresso>
<quantidadeEspectadores>10</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>450.00</valorArrecadado>
21
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>50.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>02</codigoCategoriaIngresso>
<quantidadeEspectadores>15</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>300.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>25.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>50.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>03</codigoCategoriaIngresso>
<quantidadeEspectadores>1</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
22
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
<totalizacaoCategoriaIngresso>
<codigoCategoriaIngresso>04</codigoCategoriaIngresso>
<quantidadeEspectadores>4</quantidadeEspectadores>
<totalizacoesModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>1</codigoModalidadePagamento>
<valorArrecadado>100.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>2</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
<totalizacaoModalidadePagamento>
<codigoModalidadePagamento>3</codigoModalidadePagamento>
<valorArrecadado>0.00</valorArrecadado>
</totalizacaoModalidadePagamento>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
</totalizacoesCategoriaIngresso>
</totalizacaoTipoAssento>
</totalizacoesTipoAssento>
</sessao>
</sessoes>
</Bilheteria>
JSON
{"registroANCINEExibidor":"123456"," registroANCINESala":"2456",
"diaCinematografico":"2014-08-15","houveSessoes":"S", "retificador":"N",
"sessoes":[{
"obra":{
},
"dataHoraInicio":"2014-08-15 09:23:00",
23
"modalidade":"A",
"vendedorRemoto":{
"cnpj":"39285531000103",
"razaoSocial":"BILHETERIA EVENTOS S/A"
},
"obras":[{
"numeroObra":"B8765783654124",
"tituloObra":"DOM CARLOTO",
"tipoTela":"A",
"digital":"S",
"tipoProjecao":"2",
"audio":"O",
"legenda":"N",
"libras":"S",
"legendagemDescritiva":"N",
"audioDescricao":"N",
"distribuidor":{
"cnpj":"02000879000105",
"razaoSocial":"CINEFILMES DISTRIBUIDORA LTDA"
}
}],
"totalizacoesTipoAssento":[
{"codigoTipoAssento":"P",
"quantidadeDisponibilizada":300,
"totalizacoesCategoriaIngresso":[
{"codigoCategoriaIngresso":"01",
"quantidadeEspectadores":30,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":500.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":200.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":0.00}]},
{"codigoCategoriaIngresso":"02",
"quantidadeEspectadores":130,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
24
"valorArrecadado":1000.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":200.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":100.00}]},
{"codigoCategoriaIngresso":"03",
"quantidadeEspectadores":15,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":0.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":0.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":0.00}]},
{"codigoCategoriaIngresso":"04",
"quantidadeEspectadores":50,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":300.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":150.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":50.00}]}
]},
{"codigoTipoAssento":"E",
"quantidadeDisponibilizada":30,
"totalizacoesCategoriaIngresso":[
{"codigoCategoriaIngresso":"01",
"quantidadeEspectadores":10,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":450.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":50.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":0.00}]},
{"codigoCategoriaIngresso":"02",
"quantidadeEspectadores":15,
25
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":300.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":25.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":50.00}]},
{"codigoCategoriaIngresso":"03",
"quantidadeEspectadores":1,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado":0.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":0.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":0.00}]},
{"codigoCategoriaIngresso":"04",
"quantidadeEspectadores":4,
"totalizacoesModalidadePagamento":[
{"codigoModalidadePagamento":1,
"valorArrecadado": 100.00},
{"codigoModalidadePagamento":2,
"valorArrecadado":0.00},
{"codigoModalidadePagamento":3,
"valorArrecadado":0.00}]}
]}
]}
]}
26
9.2.2 Resposta
A resposta da requisio HTTP da operao de registro de bilheteria ser definida de acordo com um dos seguintes cenrios:
9.2.2.1 Token de Autenticao Invlido ou Inexistente
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou com token que j revogado, a operao
retornar uma resposta HTTP com o cdigo 401, que significa que o processamento da requisio no foi autorizado.
9.2.2.2 Formato dos Dados de Entrada Invlido
Caso o formato dos dados enviados no esteja de acordo com as regras estipuladas neste manual, a operao retornar uma resposta HTTP
com o cdigo 400, que significa que a requisio invlida, e uma mensagem de erro especificando o problema.
9.2.2.3 Contedo dos Dados de Entrada Invlido
Caso o formato dos dados enviados esteja de acordo com as regras estipuladas neste manual mas o seu contedo esteja semanticamente
incorreto, a operao retornar uma resposta HTTP com o cdigo 422, que significa que a requisio no foi acatada, o corpo da resposta ser formado
por uma instncia do tipo StatusRegistroBilheteria descrito na seo anterior, da qual constar de alguns dados chave correspondente tentativa
de operao de registro de bilheteria conforme exemplos abaixo:
XML
<?xml version="1.0" encoding="UTF-8"?>
<StatusRegistroBilheteria>
<registroANCINEExibidor>123456</registroANCINEExibidor>
<registroANCINESala>123456</registroANCINESala>
<diaCinematografico>15/08/2014</diaCinematografico>
<numeroProtocolo></numeroProtocolo>
<statusProtocolo>N</statusProtocolo>
<mensagens>
<mensagem>
<tipoMensagem>E</tipoMensagem>
<codigoMensagem>E001</codigoMensagem>
<textoMensagem>Cdigo de Registro ANCINE do Exibidor informado invlido</textoMensagem>
</mensagem>
</mensagens>
</StatusRegistroBilheteria>
27
JSON
{"registroANCINEExibidor":"123456",
"registroANCINESala":"2456",
"diaCinematografico":"2014-08-15",
"numeroProtocolo":"",
"statusProtocolo":"N",
"mensagens":[{"tipoMensagem":"E","codigoMensagem":"E001",
"textoMensagem":"Cdigo
de
Registro
ANCINE
do
}
Exibidor
informado
invlido"}]
JSON
{"registroANCINEExibidor":"123456",
" registroANCINESala":"2456",
"diaCinematografico":"2014-08-15",
"numeroProtocolo":"46546546500054",
"statusProtocolo":"A",
"mensagens":[]
}
28
9.3
Consulta de Protocolo
Esta a operao que permitir que os exibidores verifiquem a situao do envio dos dados de bilheteria correspondente a um nmero de protocolo.
A utilizao dessa operao essencial para que os exibidores possam identificar eventuais problemas nos dados enviados, evitando assim o risco de ficarem
irregulares junto ANCINE. A execuo desta operao realizada atravs de uma requisio HTTP com os seguintes parmetros:
URL: https://scb.ancine.gov.br/scb/v1.0/protocolos/{id}*
Mtodo HTTP: GET
* A expresso aps a ltima barra representada por {id} deve ser substituda pelo nmero do protocolo que se deseja consultar.
9.3.2 Resposta
A resposta da requisio HTTP da operao de consulta de protocolo ser definida de acordo com um dos seguintes cenrios:
8.3.2.1 Token de Autenticao Invlido ou Inexistente
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou com token j revogado, a operao
retornar uma resposta HTTP com o cdigo 401, que significa que o processamento da requisio no foi autorizado.
8.3.2.2 Nmero de Protocolo Invlido ou No Informado
Caso a URL utilizada para chamar a operao de consulta de protocolo no tenha um nmero de protocolo conforme estipulado anteriormente
nesse manual, a operao retornar uma resposta HTTP com o cdigo 400, que significa que a requisio invlida.
8.3.2.3 Nmero de Protocolo Inexistente
29
Caso a URL utilizada para chamar a operao de consulta de protocolo tenha um nmero de protocolo mas este nmero de protocolo no
exista para o exibidor em questo, a operao retornar uma resposta HTTP com o cdigo 404, que significa que o protocolo no foi encontrado.
JSON
{"registroANCINEExibidor":"123456",
" registroANCINESala":"2456",
30
"diaCinematografico":"2014-08-15",
"numeroProtocolo":"46546546500054",
"statusProtocolo":"E",
"mensagens":[{"tipoMensagem":"E",
"codigoMensagem":"E003",
"textoMensagem":"Cdigo da obra audiovisual 456546 invlido"},
{"tipoMensagem":"A",
"codigoMensagem":"A002",
"textoMensagem":"Sala possui pendncias junto rea de Registro da ANCINE"}]
}
9.4
Esta a operao que permitir que os exibidores verifiquem a situao de todos os envios de dados de bilheteria de um dia cinematogrfico
especfico. Essa operao pode ser utilizada tanto como uma alternativa operao de consulta por um protocolo especfico, acima citada, como tambm em
casos que o exibidor venha a perder algum nmero de protocolo ou venha a ter algum problema de conexo com a internet entre o envio dos dados e o
recebimento do nmero do protocolo. A execuo desta operao realizada atravs de uma requisio HTTP com os seguintes parmetros:
URL: https://scb.ancine.gov.br/scb/v1.0/protocolos/?diaCinematogrfico=AAAA-MM-DD*
Mtodo HTTP: GET
* A expresso aps o ponto de interrogao representada por AAAA-MM-DD deve ser substituda pelo ano, ms e dia cinematogrfico que se deseja
consultar.
31
9.4.2 Resposta
A resposta da requisio HTTP da operao de consulta de protocolos por dia cinematogrfico ser definida de acordo com um dos seguintes cenrios:
8.4.2.1 Token de Autenticao Invlido ou Inexistente
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou que j tenha sido revogado, a operao
retornar uma resposta HTTP com o cdigo 401, que significa que o processamento da requisio no foi autorizado.
8.4.2.2 Data invlida ou no informada
Caso a URL utilizada para chamar a operao de consulta de protocolos de um dia cinematogrfico no especifique o parmetro
diaCinematogrfico ou no obedea ao formato de datas estipulado anteriormente nesse manual, a operao retornar uma resposta HTTP com o
cdigo 400, que significa que a requisio invlida.
8.4.2.3 Formato dos Dados de Entrada Vlido
Caso um dia cinematogrfico seja devidamente passado na requisio, a operao retornar uma resposta HTTP com o cdigo 200, que
significa que a requisio vlida. O corpo da resposta ser formado por uma coleo de instncias do tipo StatusRegistroBilheteria, j descrita
neste manual, que constar, alm de alguns dados chave, de um nmero de protocolo correspondente operao de registro de bilheteria e eventuais
mensagens de erro ou alerta conforme o caso.
9.5
Esta a operao que permitir que os exibidores verifiquem a condio de adimplncia em relao obrigao do envio dos relatrios de bilheteria
de cada uma de suas salas de exibio cinematogrficas registradas em um dia cinematogrfico especfico. A execuo desta operao realizada atravs de
uma requisio HTTP com os seguintes parmetros:
URL: https://scb.ancine.gov.br/scb/v1.0/adimplencia/AAAA-MM-DD*
Mtodo HTTP: GET
* A expresso aps o ponto de interrogao representada por AAAA-MM-DD deve ser substituda pelo ano, ms e dia cinematogrfico que se deseja
consultar a condio de adimplncia.
32
9.5.2 Resposta
A resposta da requisio HTTP da operao de consulta da condio de adimplncia por dia cinematogrfico ser definida de acordo com um dos
seguintes cenrios:
9.5.2.1 Token de Autenticao Invlido ou Inexistente
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou que j tenha sido revogado, a operao
retornar uma resposta HTTP com o cdigo 401, que significa que o processamento da requisio no foi autorizado.
9.5.2.2 Data invlida ou no Informada
Caso a URL utilizada para chamar a operao de consulta de condio de adimplncia em um dia cinematogrfico no especifique a data ou
no obedea ao formato de datas estipulado anteriormente nesse manual, a operao retornar uma resposta HTTP com o cdigo 400, que significa
que a requisio invlida.
9.5.2.3 Formato dos Dados de Entrada Vlido
Caso um dia cinematogrfico seja devidamente passado na requisio, a operao retornar uma resposta HTTP com o cdigo 200, que
significa que a requisio vlida. O corpo da resposta ser formado por uma coleo de instncias do tipo SituacaoAdimplencia, j descrita neste
manual, conforme exemplo abaixo:
XML
<?xml version="1.0" encoding="UTF-8"?>
<AdimplenciaExibidor>
<registroANCINEExibidor>9875654</registroANCINEExibidor>
<diaCinematografico>2014-08-15</diaCinematografico>
<adimplenciaSalas>
33
<adimplenciaSala>
<registroANCINESala>5003456</registroANCINESala>
<situacaoSala>V</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<registroANCINESala>5004877</registroANCINESala>
<situacaoSala>E</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<registroANCINESala>5004557</registroANCINESala>
<situacaoSala>N</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<registroANCINESala>5007888</registroANCINESala>
<situacaoSala>A</situacaoSala>
</adimplenciaSala>
</adimplenciaSalas>
</AdimplenciaExibidor>
JSON
{"registroANCINEExibidor":"9875654",
"diaCinematografico":"2014-08-15",
"adimplenciaSalas":[
{"registroANCINESala": "5003456",
"situacaoSala":"V"},
{"registroANCINESala": "5004877",
"situacaoSala":"V"},
{"registroANCINESala": "5004557",
"situacaoSala":"N"},
{"registroANCINESala": "5007888",
"situacaoSala":"A"}
]
}
34
Captulo II
Certificao dos Sistemas
de Transmisso
1. Introduo
Este captulo do manual tem como objetivo apresentar os procedimentos necessrios para que o
exibidor de obras audiovisuais no segmento de salas de exibio obtenha a certificao que lhe
possibilitar enviar os dados de bilheteria Agncia Nacional do Cinema - ANCINE e, assim, cumprir
com o disposto na Instruo Normativa que regulamenta o Sistema de Controle de Bilheteria (SCB).
36
2. Ambientes
A Agncia Nacional do Cinema ANCINE disponibilizar dois ambientes aptos para recepo dos dados
de bilheteria dos exibidores a saber:
Produo: Ambiente oficial para onde os dados reais de exibio cinematogrfica dos
exibidores devero ser enviados para cumprimento do disposto na Instruo Normativa. Os
exibidores apenas conseguiro utilizar este ambiente aps cumprir com sucesso todo o
procedimento estabelecido neste captulo do Manual Tcnico. Esse ambiente est disponvel
atravs do endereo: scb.ancine.gov.br/scb/v1.0/
37
3. Tokens
O token uma cadeia de caracteres alfanumricos nica utilizada para identificar e autenticar o
exibidor em seus acessos ao Sistema de Controle de Bilheteria tanto para envio de dados de bilheteria
quanto para consultas de seus protocolos ou situao de adimplncia. Portanto, o exibidor deve ter
ao menos um token vlido para conseguir utilizar qualquer um dos servios do Sistema de Controle
de Bilheterias.
Os tokens so gerados pelo prprio exibidor atravs de uma pgina dentro do SAD Sistema ANCINE
Digital que pode ser acessada atravs do menu Outros Servios/Controle de Bilheterias/Tokens.
Nessa tela ele poder visualizar seus tokens, gerar novos tokens e at mesmo revogar algum token.
Ao gerar um novo token o exibidor dever especificar o tipo do token que deseja gerar:
Certificao/Teste ou Produo. Sendo cada um destes tipos vlidos apenas no ambiente de mesmo
nome conforme descrito na seo anterior, ou seja, o primeiro tipo ser vlido apenas no ambiente de
certificao/teste, enquanto o segundo ser vlido apenas no ambiente de produo. Vale lembrar
que a opo para se gerar um token do tipo Produo estar disponvel apenas quando o exibidor
tiver realizado com sucesso o envio de um conjunto de relatrios de bilheteria que ser detalhado
nas prximas sesses deste captulo do Manual Tcnico.
Aps a gerao do token, o sistema de informao do exibidor responsvel pelo envio dos relatrios
de bilheteria e consulta de protocolos deve utiliz-lo para se autenticar em cada uma das chamadas
aos servios/operaes do web service do Sistema de Controle de Bilheteria conforme estabelecido
no primeiro captulo deste manual.
38
4. Procedimento de Certifico
O procedimento de certificao do exibidor simples e tem como objetivo prover uma forma de
atestar que o exibidor interpretou corretamente a Instruo Normativa e as instrues referente
estrutura dos dados e transmisso contidas neste manual, bem como, realizou a correta
implementao em seu sistema de informao responsvel pela transmisso dos relatrios de
bilheteria ao SCB antes da sua utilizao no ambiente de Produo.
Para obter a certificao, que permitir ao exibidor gerar tokens do tipo Produo que por sua vez lhe
possibilitar o envio dos seus dados de bilheterias para cumprimento do disposto na Instruo
Normativa 123, o exibidor deve ter enviado para o ambiente de Certificao ao menos um relatrio de
bilheteria considerado vlido com cada uma das caractersticas a seguir:
Lembrando mais uma vez que os dados enviados para o ambiente de certificao no precisam ser
dados reais de bilheteria do exibidor, ou seja, podero ser utilizados dados fictcios neste ambiente.
Aps o envio de ao menos um relatrio de bilheteria para cada caracterstica acima, o exibidor deve
aguardar o processamento desses relatrios e, caso o processamento no tenha acusado erros, o
exibidor ter, automaticamente, a opo de gerao de tokens do tipo Produo habilitada na tela de
gerao de tokens dentro do SAD Sistema ANCINE Digital.
39
5. Arquitetur d Soluo
*
SAD
http://sad.ancine.gov.br
SCB site
Certificao
5. Nmero de protocolo
http://scbcertificacao.ancine.gov.br/scb/v1.0/
Assim que os dados enviados para o site de certificao forem processados e validados, o exibidor
j estar certificado e poder prosseguir com os passos seguintes para enviar efetivamente os
dados reais para o site de produo para cumprimento da obrigao normativa.
*
6. Gerar token para o site de produo
do SCB no SAD Sistema ANCINE Digital
SAD
http://sad.ancine.gov.br
SCB site
Produo
* Para entrar no SAD e gerar o token ser utilizado o mesmo nome de usurio
usado para realizar outras operaes.
40
6. Tutoril
Nesta seo iremos apresentar um tutorial prtico dos procedimentos que o exibidor deve seguir
resumindo todo o procedimento descrito nas sees anteriores.
41
B. Obteno da Certificao
a. Configurar o sistema a ser certificado para enviar os dados dos relatrios de bilheteria
para o ambiente de Certificao do SCB
b. Informar no sistema o token do tipo Certificao que foi gerado no item 1 deste
tutorial (o token deve ser enviado no cabealho de cada comunicao realizada com
o webservice do SCB)
c. Enviar um relatrio de bilheteria, que poder ser fictcio, de uma sala de exibio e dia
que tenha sesses cinematogrficas
d. Enviar um relatrio de bilheteria, que poder ser fictcio, de uma sala de exibio e dia
que no tenha sesses cinematogrficas
e. Enviar um relatrio de bilheteria, que poder ser fictcio, de retificao de algum dos
relatrios de bilheteria j enviados anteriormente
f. Aguardar o processamento por parte do SCB
g. Caso os relatrios tenham sido enviados corretamente, j ser possvel seguir para o
item C, caso contrrio ser necessrio corrigir os problemas apontados pela validao
e reenviar os relatrios de bilheteria que apresentaram erros
42
43
44
Captulo III
Perguntas Frequentes
46
47
48
3. Outros
a. Como devo proceder no caso de dvidas ou dificuldades na execuo
das orientaes contidas neste manual?
As dvidas e problemas devem ser direcionadas ao e-mail scb@ancine.gov.br da
Superintendncia de Anlise de Mercado (SAM).
49
Captulo IV
Anexos
Causa
Exibidor com prazo de revalidao de registro da ANCINE expirado
Exibidor no se encontra com seu registro deferido pela ANCINE
Sala de Exibio no se encontra com a situao Em funcionamento
Sesso cinematogrfica iniciando antes do trmino da sesso anterior
CNPJ do principal prestador de servio de venda remota de bilhetes de ingresso invlido
Razo social do principal prestador de servio de venda remota de bilhetes de ingresso no foi informada
Nmero de CPB/ROE informado no possui um CRT vigente para o segmento de Salas de Exibio
CNPJ do distribuidor da obra no pertence a um agente distribuidor registrado na ANCINE
Nmero de assentos disponibilizados para a sesso maior que o nmero de assentos informados no registro da sala
O PMI de cada categoria de ingressos deve estar entre R$1,00 e R$200
Mensagens de Erro
Cdigo
E000
E010
E011
E020
E021
E030
E031
E032
Causa
Cdigo de Registro ANCINE do Exibidor informado invlido
Cdigo de Registro ANCINE da Sala de Exibio informado invlido
Cdigo de Registro ANCINE da Sala de Exibio informado no pertence a este exibidor
Dia cinematogrfico ao qual se refere os dados de bilheteria no foi informado ou est fora do formato estabelecido no Manual Tcnico (AAAAMM-DD)
O dia cinematogrfico reportado corresponde a um dia de exibio futuro
Indicador da existncia de sesses cinematogrficas no foi informado ou seu valor no corresponde ao domnio esperado
Relatrio indica existncia de sesses cinematogrficas mas no foi encontrada nenhuma sesso no corpo do relatrio
Relatrio indica inexistncia de sesses cinematogrficas mas foram encontrados dados de sesses cinematogrficas no corpo do relatrio
51
E040
E041
E042
E043
E100
E101
E102
E110
E120
E121
E130
E140
E200
E201
E202
E210
E220
E221
E230
E231
E232
E233
E234
E235
Indicador da natureza retificadora ou no do relatrio no foi informado ou seu valor no corresponde ao domnio esperado
J existem registros de bilheteria para a sala cinematogrfica neste dia. Caso esta seja a ao desejada, indique o atributo 'retificador' com o valor
'S'
O relatrio enviado est assinalado como uma retificao, entretanto, no existem registros de bilheteria para a sala cinematogrfica neste dia
cinematogrfico. Para enviar um relatrio original, indique o atributo 'retificador' com o valor 'N'
As retificaes de relatrios s podem ser realizadas at 30 dias aps o respectivo dia cinematogrfico. Aps esse prazo necessrio entrar em
contato com a ANCINE e solicitar autorizao para realizar esta retificao
Existem sesses cinematogrficas para as quais no foi informado o horrio de incio
A data e hora da sesso no correspondem ao dia cinematogrfico informado
Foi informada mais de uma sesso cinematogrfica com mesmo horrio de incio
Modalidade da sesso cinematogrfica no foi informada ou seu valor no corresponde ao domnio esperado
CNPJ do principal prestador de servio de venda remota de bilhetes de ingresso invlido
Razo social do principal prestador de servio de venda remota de bilhetes de ingresso invlida
No foram encontrados os dados sobre as obras audiovisuais exibidas na sesso cinematogrfica
No foram encontrados os dados sobre a totalizao de assentos disponibilizados para a sesso cinematogrfica
Cdigo CPB, ROE ou Cdigo Genrico da obra audiovisual informado invlido
O somatrio da durao das obras exibidas em um dia cinematogrfico na sala ultrapassa 24 horas
Existem nmeros de obras repetidos na sesso cinematogrfica
Ttulo da obra audiovisual no foi informado ou excedeu a quantidade mxima de 100 caracteres
CNPJ do distribuidor da obra invlido
Razo social do distribuidor da obra cinematogrfica exibida no foi informada
O tipo da tela de projeo da sesso cinematogrfica no foi informado ou seu valor no corresponde ao domnio esperado
Indicador da utilizao ou no de mdias digitais para projeo no foi informado ou seu valor no corresponde ao domnio esperado
O tipo de projeo da sesso cinematogrfica no foi informado ou seu valor no corresponde ao domnio esperado
A forma de reproduo do udio da obra na sesso cinematogrfica no foi informada ou seu valor no corresponde ao domnio esperado
Indicador da exibio de legendas na projeo da obra audiovisual no foi informado ou seu valor no corresponde ao domnio esperado
Indicador da disponibilidade de traduo da obra audiovisual para a lngua brasileira de sinais (libras) na sesso cinematogrfica no foi informado
ou seu valor no corresponde ao domnio esperado
52
E236
E237
E300
E301
E302
E310
E400
E401
E402
E410
E411
E500
E501
E502
E510
E520
E521
Indicador da disponibilidade de legendagem descritiva na sesso cinematogrfica no foi informado ou seu valor no corresponde ao domnio
esperado
Indicador da disponibilidade de audiodescrio na sesso cinematogrfica no foi informado ou seu valor no corresponde ao domnio esperado
Foi utilizado um cdigo de tipo de assento invlido na sesso cinematogrfica
Existem tipos de assento repetidos na sesso cinematogrfica
No foram enviados dados de todos os tipos de assento previstos
A quantidade de assentos disponibilizados deve ser um valor numrico entre 0 e 9.999
Foi utilizado um cdigo de categoria de ingressos invlido. Verifique o Anexo II do Manual Tcnico
No foram enviados dados de todas categorias de ingresso previstas
Existem categorias de ingressos repetidas dentro de um mesmo tipo de assento
Existem categorias de ingressos com quantidade de espectadores que no corresponde ao domnio esperado
Somatrio de espectadores de cada categoria maior que o nmero de assentos daquele tipo disponibilizados para a sesso
Foi utilizado um cdigo de modalidade de pagamento invlido. Verifique o Anexo III do Manual Tcnico
No foram enviados dados de arrecadao de todas as modalidades de pagamento previstas
Existem modalidades de pagamento repetidas dentro de uma mesma categoria de ingresso
Existem modalidades de pagamento com valor arrecadado que no corresponde ao domnio esperado
Existem categorias de ingressos sem espectadores informando valor de arrecadao
Foi informado valor de arrecadao para ingressos da categoria Cortesia
Nome
Inteira
Meia-entrada
Cortesia
Descrio
Bilhetes vendidos ao preo normal praticado na sesso para cada tipo de assento, sem descontos.
Bilhetes vendidos metade do preo inteiro, por imposio da legislao, seja para estudantes ou no estudantes
Bilhetes oferecidos gratuitamente ao espectador.
53
04
Promocional
Bilhetes vendidos com desconto para grupos especiais de espectadores, inclusive aqueles com desconto de 50% que no se
trate da meia-entrada obrigatria por lei.
Outras
Descrio
Valores arrecadados por meios de pagamentos tradicionais tais como: dinheiro, cheque, carto de dbito ou crdito.
Valores arrecadados atravs do Vale-Cultura, benefcio criado pelo Ministrio da Cultura e que fornecido pelas
empresas aos seus empregados.
Valores arrecadados por outros meios de pagamento como, por exemplo, carteiras digitais.
54