Manual TecnicoSCB

Sistema de Controle de Bilheteria (SCB)
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:
Registro de Bilheteria de Sala de Exibio: Transmite ANCINE os relatrios de

bilheteria de todas as sesses cinematogrficas realizadas em uma determinada sala de
exibio, em um dia cinematogrfico especfico. Assim, para a transmisso dos dados de
um determinado dia cinematogrfico, a quantidade de vezes que essa operao ser
acionada exatamente igual ao nmero de salas de exibio de que o exibidor ou grupo
exibidor dispe. Essa mesma operao ser realizada para retificaes de relatrios de
bilheteria j enviados.
Consulta de Protocolo: Retorna status atual do envio dos relatrios de bilheteria

referentes ao protocolo informado. Caso os dados do relatrio j tenham sido
processados pela ANCINE e tenham apresentado problemas, a resposta dessa operao
tambm incluir a relao dos problemas encontrados.
Consulta de Protocolos de um dia cinematogrfico: Retorna status atual de todos os

envios dos relatrios de bilheteria referentes a um determinado dia cinematogrfico.
Consulta de Situao de Adimplncia: Retorna informao sobre a situao de

adimplncia ou inadimplncia em relao obrigao de envio dos relatrios de
bilheteria de cada sala de exibio cinematogrfica cujo registro na ANCINE esteja
associado ao exibidor.
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
Todo o trfego de informaes realizado utilizando o protocolo HTTPS, que o padro da

internet para trafegar dados de maneira segura.
A conexo HTTPS criptografada e a autenticidade do servidor verificada atravs de
certificado digital.
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:
Um protocolo no estado Em anlise no atesta a consistncia ou fidedignidade dos dados

enviados, apenas atesta que foram recebidos pela ANCINE no formato determinado pela
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:
O reenvio (retificao) de relatrios j validados, ou seja, relatrios com formato correto e

contedo aceito pela crtica em segunda instncia, s poder ocorrer dentro de 30 dias a partir
do dia cinematogrfico informado, e, aps esse prazo, somente se autorizado pela ANCINE
mediante justificativa.
5. Tipos de Ddos Simples

Abaixo seguem as formataes de dados que devem ser seguidas para gerao correta das
mensagens enviadas ao web service do Sistema de Controle de Bilheteria SCB.
Tipo do Dado
Data
Data Hora
Inteiro[min-max]
Decimal
Texto[min-max]
Booleano
Descrio e Formato Esperado

Representa dados de data sem especificao de horrio
Formato: AAAA-MM-DD
Onde:
DD = Nmero com 2 caracteres que representa o dia do ms
MM = Nmero com 2 caracteres que representa o ms
AAAA = Nmero com 4 caracteres que representa o ano
Exemplo: 2001-09-06
Representa dados de data e hora
Formato: AAAA-MM-DD HH:mm:ss
Onde:
DD = Nmero com 2 caracteres que representa o dia do ms
MM = Nmero com 2 caracteres que representa o ms
AAAA = Nmero com 4 caracteres que representa o ano
HH = Nmero com 2 caracteres que representa as horas (de 00 a 23)
mm = Nmero com 2 caracteres que representa os minutos (de 00 a 59)
ss = Nmero com 2 caracteres que representa os segundos (de 00 a 59)
Exemplo: 2001-09-06 17:58:00
Representa nmeros inteiros positivos ou negativos. Os campos definidos
como tipo Inteiro neste manual viro seguidos de uma especificao do
nmero de dgitos mnimo e mximo permitidos no respectivo campo.
Representa nmeros com parte fracionria. Os campos definidos como
tipo Decimal neste manual aceitam no mximo 13 dgitos em sua parte
inteira.
Formato: 0.00
OBS: No deve ser utilizado separador de milhar. O ponto deve ser
utilizado para separar a parte inteira da fracionria, sendo que a parte
fracionria deve ser composta de no mximo dois dgitos.
Exemplo:
1112.00
Representa dados alfanumricos. Os campos definidos como tipo Texto
neste manual viro seguidos de uma especificao da quantidade mnima
e mxima de caracteres permitidos no valor do respectivo dado.
Representa dados booleanos cujo valor deve ser representado com S
para SIM e N para NO
6. Formto de Especifico ds Entiddes

No escopo deste manual, entende-se por entidades as estruturas de dados compostas que possuem significado semntico dentro do processo de transmisso
de dados de bilheteria. Do ponto de vista da anlise orientada a objetos, uma entidade pode ser entendida como uma classe e, como esta, composta de um
conjunto de atributos que podem tanto ser de tipos simples (descritos na ltima seo) como de outras entidades. Nas prximas sees deste manual, ser
apresentada cada uma das entidades utilizando-se uma notao tabular como a que segue:
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
Relao entre as Entidades
10
7.2
Entidades utilizadas para envio dos dados de bilheteria ANCINE
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
Entidades utilizadas para recebimento de resposta do status do envio
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
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
Entidades utilizadas para consultar a situao de adimplncia de salas junto ao SCB
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
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
8. Codigos Genericos de Obrs Audiovisuis

As obras audiovisuais no publicitrias brasileiras exibidas nas salas cinematogrficas em territrio brasileiro devem, obrigatoriamente, ter seu Certificado de
Produto Brasileiro (CPB) concedido pela ANCINE. O CPB consiste em um cdigo alfanumrico que identifica as obras brasileiras de forma nica. Da mesma
forma, as obras audiovisuais no publicitrias estrangeiras tambm devem ter seu Registro de Obra Estrangeira (ROE). O ROE tambm consiste em um cdigo
alfanumrico que identifica as obras estrangeiras com fins comerciais em territrio nacional.
Conforme descrito nas sees anteriores, esses dois cdigos sero utilizados para identificao das obras exibidas nas sesses cinematogrficas. Entretanto,
alguns casos especficos de obras audiovisuais, tais como alguns tipos de obras no cinematogrficas, no requerem a emisso de CPB ou ROE para sua
exibio. Para que o exibidor possa comunicar ento a exibio de tais obras, foi criado um conjunto de cdigos genricos para que se possa identificar a obra
exibida na sesso cinematogrfica. So eles:
G0000000000001: Eventos Esportivos

G0000000000002: Shows e Musicais
G0000000000003: Jogos Eletrnicos
G0000000000004: Mostras e Festivais
16
9. Formto de Entrd e Sd ds Operoes

9.1
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.
Registro de Bilheteria de Sala de Exibio
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>
</totalizacoesModalidadePagamento>
</totalizacaoCategoriaIngresso>
20
</totalizacoesCategoriaIngresso>
</totalizacaoTipoAssento>
<totalizacaoTipoAssento>
<codigoTipoAssento>E</codigoTipoAssento>
<quantidadeDisponibilizada>30</quantidadeDisponibilizada>
<totalizacoesCategoriaIngresso>
21
22
</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},
"valorArrecadado":0.00}]},
24
"valorArrecadado":50.00}]}
]},
{"codigoTipoAssento":"E",
"quantidadeDisponibilizada":30,
"totalizacoesCategoriaIngresso":[
25
"valorArrecadado": 100.00},
"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
<StatusRegistroBilheteria>
<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"}]
9.2.2.4 Formato e Contedo dos Dados de Entrada Vlido

Caso o formato dos dados enviados esteja de acordo com as regras estipuladas neste manual e semanticamente corretos, a operao retornar
uma resposta HTTP com o cdigo 201, que significa que os dados do registro foram aceitos. O corpo da resposta ser formado por uma instncia do
tipo StatusRegistroBilheteria descrito na seo anterior, da qual constar, alm de alguns dados chave, um nmero de protocolo correspondente
operao de registro de bilheteria conforme exemplos abaixo:
XML
<diaCinematografico>15/08/2014</diaCinematografico>
<numeroProtocolo>46546546500054</numeroProtocolo>
<statusProtocolo>A</statusProtocolo>
JSON
" registroANCINESala":"2456",
"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.

A operao de consulta de protocolo espera receber o nmero de protocolo cujo status se queira obter. Esse nmero, conforme citado acima,
informado na prpria formao da URL de acesso operao.
9.3.2 Resposta
A resposta da requisio HTTP da operao de consulta de protocolo ser definida de acordo com um dos seguintes cenrios:
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou com token j revogado, a operao
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.
8.3.2.4 Formato dos Dados de Entrada Vlido

Caso um nmero de protocolo 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 instncia do tipo StatusRegistroBilheteria, descrito na seo anterior,
que constar, alm de alguns dados chave, de um nmero de protocolo correspondente operao de registro de bilheteria conforme exemplos
abaixo:
XML
<numeroProtocolo>46546546500054</numeroProtocolo>
<statusProtocolo>E</statusProtocolo>
<mensagens>
<mensagem>
<tipoMensagem>E</tipoMensagem>
<codigoMensagem>E003</codigoMensagem>
<textoMensagem>Cdigo da obra audiovisual 456546 invlido</textoMensagem>
</mensagem>
<mensagem>
<tipoMensagem>A</tipoMensagem>
<codigoMensagem>A002</codigoMensagem>
<textoMensagem>Sala possui pendncias junto rea de Registro da ANCINE</textoMensagem>
</mensagem>
</mensagens>
JSON
" registroANCINESala":"2456",
30
"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
Consulta de Protocolos de um dia cinematogrfico
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.

A operao de consulta de protocolo espera receber a data do dia cinematogrfico cujo status se queira obter. Essa data, conforme citado acima,
informado na prpria formao da URL de acesso operao.
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:
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou que j tenha sido revogado, a operao
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.
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
Consulta de Situao de Adimplncia
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

A operao de consulta da condio de adimplncia espera receber a data do dia cinematogrfico que se deseja consultar. Essa data, conforme citado
acima, informado na prpria formao da URL de acesso operao.
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:
Caso a requisio tenha sido realizada sem um token de autenticao, com um token inexistente ou que j tenha sido revogado, a operao
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.
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
<AdimplenciaExibidor>
<adimplenciaSalas>
33
<adimplenciaSala>
<situacaoSala>V</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<situacaoSala>E</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<situacaoSala>N</situacaoSala>
</adimplenciaSala>
<adimplenciaSala>
<situacaoSala>A</situacaoSala>
</adimplenciaSala>
</adimplenciaSalas>
</AdimplenciaExibidor>
JSON
"adimplenciaSalas":[
{"registroANCINESala": "5003456",
"situacaoSala":"V"},
"situacaoSala":"V"},
"situacaoSala":"N"},
"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/
Certificao/Teste: Ambiente no qual os exibidores devero enviar um conjunto especfico de

relatrios de bilheteria, detalhado posteriormente neste Manual, e por meio do qual tambm
podero realizar testes da transmisso dos dados de bilheteria entre seus sistemas de
informao e o web service do Sistema de Controle de Bilheteria. Ao contrrio do ambiente de
Produo, no ambiente de Certificao os exibidores podero enviar dados fictcios. Esse
ambiente est disponvel atravs do endereo: scbcertificacao.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:
Um relatrio de bilheteria sem sesses cinematogrficas: Esse relatrio demonstrar que o

sistema do exibidor reporta corretamente os casos em que a sala cinematogrfica no teve
nenhuma sesso em uma determinada data.
Um relatrio de bilheteria com sesses cinematogrficas: Esse relatrio demonstrar que o
sistema do exibidor reporta corretamente os dias de operao normal de uma sala
cinematogrfica, ou seja, os dias em que houve sesses cinematogrficas.
Um relatrio de bilheteria retificador: Esse relatrio demonstrar que o sistema do exibidor
sabe comunicar uma retificao de relatrio de bilheteria ao SCB.
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
*
1. Gerar token para o site de certificao

do SCB no SAD Sistema ANCINE Digital
SAD
2. Token para o site de certificao
http://sad.ancine.gov.br
Funcionrio do Agente Exibidor
3. Registrar o token de certificao gerado no

Sistema de Informao responsvel pelo envio de
dados de bilheteria ao SCB
4. Enviar conjunto de relatrios fictcios de
bilheteria ao site de certificao do SCB
SCB site
Certificao
5. Nmero de protocolo
http://scbcertificacao.ancine.gov.br/scb/v1.0/
Sistema de Informao do Agente Exibidor
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
7. Token para o site de produo

Funcionrio do Agente Exibidor
http://sad.ancine.gov.br
8. Registrar o token de produo gerado no Sistema

de Informao responsvel pelo envio de dados de
bilheteria ao SCB
9. Enviar conjunto de relatrios de
bilheteria ao site de produo do SCB
10. Nmero de protocolo
SCB site
Produo
Sistema de Informao do Agente Exibidor

https://scb.ancine.gov.br/scb/v1.0/
* 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.
A. Gerao do Token de Certificao

a. Acessar o SAD Sistema ANCINE digital
b. Logar no sistema informando seu usurio e senha
c. Acessar a tela de gerao de tokens atravs do menu Outros Servios/Controle de

Bilheterias/Tokens
41
d. Clicar em Gerar Token e marcar a opo Certificao
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
C. Gerao do Token de Produo

a. Acessar o SAD Sistema ANCINE digital
b. Logar no sistema informando seu usurio e senha
42
c. Acessar a tela de gerao de tokens atravs do menu Outros Servios/Controle de

Bilheterias/Tokens
d. Clicar em Gerar Token e marcar a opo Produo (a opo Produo s estar

habilitada caso o item B tenha sido concludo com sucesso)
43
D. Envio dos Dados de Bilheteria de Produo

a. Configurar o sistema certificado para enviar os dados dos relatrios de bilheteria para
o ambiente de Produo do SCB
b. Informar no sistema o token do tipo Produo que foi gerado no item C deste
tutorial (o token deve ser enviado no cabealho de cada comunicao realizada com
o webservice do SCB)
c. Enviar os dados de bilheteria
d. Aguardar o processamento por parte do SCB
e. Consultar cada um dos protocolos
f. Verificar as mensagens da consulta do protocolo, corrigir os problemas daqueles
relatrios que apresentaram erros e reenvi-los
44
Captulo III
Perguntas Frequentes
1. Estrutur de Ddos e Trnsmisso

a. O que o SCB?
Sistema de Controle de Bilheteria (SCB), regulamentado pela Instruo Normativa 123 da
ANCINE
(http://ancine.gov.br/legislacao/instrucoes-normativas-consolidadas/instru-onormativa-n-123-de-22-de-dezembro-de-2015-0), o conjunto de solues de Tecnologia da
Informao e Comunicao (TIC), definidos pela ANCINE, para gerao, transmisso e recepo
dos resultados de bilheteria dos exibidores e para certificao do sistema utilizado pelo
exibidor.
b. Quem obrigado a enviar as informaes dirias de exibio para o

SCB?
O envio obrigatrio para exibidores responsveis por salas comerciais de cinema, assim
entendidas como aquelas que atendam concomitantemente s seguintes caractersticas:
- tecnologia de projeo de imagens com o uso de equipamentos digitais de alta
performance ou projetores de filmes de 35mm;
- programao formada, predominantemente, por longas-metragens com lanamento
comercial no Brasil nos ltimos 12 meses; e
- modelo de negcio com predomnio de cobrana de ingressos.
O envio facultativo para as unidades itinerantes de cinema e para as salas no comerciais
de cinema.
c. Sou obrigado a enviar os dados de bilheteria de todas as sesses?

Para salas comerciais de cinema, o envio das informaes obrigatrio para todas as sesses,
inclusive as relativas a mostras e festivais e sesses no cinematogrficas.
d. A partir de quando o envio de informaes ao SCB passa a ser

obrigatrio?
Os exibidores responsveis devero adequar seus sistemas e iniciar a transmisso dos dados
nos seguintes prazos:
I at 28 de julho de 2016, no caso das redes exibidoras com mais de 20 (vinte) salas;
II at 28 de setembro de 2016, no caso das demais redes exibidoras.
e. Como fao para enviar minhas informaes de exibio diariamente?

A transmisso dos dados de bilheteria dever ser feita por meio de sistema que observe as
especificaes deste Manual.
46
f. Qual o prazo para o envio das informaes dirias de exibio?

I at s 10h (dez horas) do dia seguinte ao dia de exibio relatado, no caso dos complexos
situados em municpios com populao igual ou superior a 200 (duzentos) mil habitantes; ou
II at s 15h (quinze horas) do dia seguinte ao dia de exibio relatado, nos demais casos.
g. Se tiver alguma sala sem registro, como devo proceder?

No ser possvel enviar as informaes de uma sala que no esteja registrada na ANCINE. O
exibidor deve entrar em contato com Superintendncia de Registro, atravs do email:
registro.empresa@ancine.gov.br .
h. Como fao para corrigir e reenviar informaes que no foram aceitas

por causa de um erro?
Em caso de falha na validao da estrutura ou na transmisso dos dados, responsabilidade
do exibidor verificar o motivo e assegurar que novo relatrio seja gerado e transmitido
corretamente, por meio de uma retificao de protocolo.
i. Quanto tempo tenho para retificar as informaes que foram enviadas

se desejo corrigir algum dado? E se precisar retificar uma informao
depois desse prazo?
Poder haver retificao dos dados at 30 (trinta) dias aps o dia de exibio relatado, por
meio da gerao e transmisso de novo relatrio, que indique uma retificao.
Aps este prazo, um relatrio de dados de bilheteria j transmitido e com protocolo emitido
s poder ser retificado com autorizao da ANCINE, mediante justificativa do exibidor.
j. Recebi um e-mail com notificao de inadimplncia, o que devo fazer?

Nesse caso, o exibidor deve, ento, enviar as informaes de exibio referentes
inadimplncia informada. Caso no tenha havido sesses naquele dia cinematogrfico, deve
enviar o relatrio com essa informao.
k. Se no consigo enviar as informaes porque o cdigo de alguma obra

no est sendo aceito, como devo proceder?
No ser possvel enviar as informaes de uma obra sem nmero ROE (estrangeira) ou CPB
(brasileira). Nesse caso, o cdigo da obra (ROE ou CPB) dever ser consultado via SAD, no Menu
Consultas (no alto direita).
47
l. O que acontece se enviarmos um relatrio de bilheteria sem gerar um

token?
Ao realizar qualquer acesso ao web service do SCB sem informar um token, a operao no
ser concluda pois o SCB no conseguir identificar quem est fazendo a chamada e, assim,
retornar um erro HTTP 401 (Acesso no autorizado)
m. O que acontece se enviarmos um relatrio de bilheteria para o

ambiente de produo com um token do tipo Certificao ou viceversa?
O SCB interpretar como um token invlido e retornar um erro HTTP 401 (Acesso no
autorizado)
2. Certifico dos Sistems

a. Existe um limite de tokens que podemos gerar?
No existe um limite do nmero de tokens a serem gerados pelo exibidor, entretanto, a
responsabilidade pela sua guarda e administrao de responsabilidade do exibidor
48
b. Existe um limite de relatrios de bilheteria que podemos enviar para

o ambiente de Certificao?
No h limites de nmero de relatrios de bilheteria enviados para nenhum ambiente.
c. Podemos utilizar o ambiente de Certificao para testar nosso

sistema?
Sim. Um dos propsitos deste ambiente que os exibidores possam realizar testes dos seus
sistemas de transmisso de dados de bilheteria
d. Quando a verso do nosso sistema mudar ou caso troquemos de

soluo precisaremos passar novamente pelo processo de
certificao?
No. A certificao do exibidor e no do sistema. A partir do momento que o exibidor adquire
a certificao ele no mais precisar passar por este processo. Entretanto, de sua
responsabilidade o erro nos envios de dados provocados pela troca de verso/sistema que no
atenda ao estabelecido na Instruo Normativa e neste manual. Embora no seja obrigatrio
a certificao, altamente recomendado que o exibidor utilize o site de certificao para fazer
a validao de seu sistema antes de comear a enviar os dados para o ambiente de produo.
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
Anexo I Mensgens ds Operoes

Mensagens de Alerta
Cdigo
A000
A001
A010
A100
A120
A121
A200
A220
A310
A510
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
Anexo II Ctegoris de Ingressos

Categorias de Ingressos
Cdigo
01
02
03
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.
Anexo III Modliddes de Pgmentos

Categorias de Ingressos
Cdigo Nome
1
Meios tradicionais
2
Vale-Cultura
3
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

Manual TecnicoSCB

Hochgeladen von

Dokumentinformationen

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

Manual TecnicoSCB

Hochgeladen von

Copyright:

Verfügbare Formate

Sistema de Controle de Bilheteria (SCB)

Registro de Bilheteria de Sala de Exibio: Transmite ANCINE os relatrios de

Consulta de Protocolo: Retorna status atual do envio dos relatrios de bilheteria

Consulta de Protocolos de um dia cinematogrfico: Retorna status atual de todos os

Consulta de Situao de Adimplncia: Retorna informao sobre a situao de

Todo o trfego de informaes realizado utilizando o protocolo HTTPS, que o padro da

Um protocolo no estado Em anlise no atesta a consistncia ou fidedignidade dos dados

O reenvio (retificao) de relatrios j validados, ou seja, relatrios com formato correto e

5. Tipos de Ddos Simples

Descrio e Formato Esperado

6. Formto de Especifico ds Entiddes

Relao entre as Entidades

Entidades utilizadas para envio dos dados de bilheteria ANCINE

Entidades utilizadas para recebimento de resposta do status do envio

Entidades utilizadas para consultar a situao de adimplncia de salas junto ao SCB

8. Codigos Genericos de Obrs Audiovisuis

G0000000000001: Eventos Esportivos

9. Formto de Entrd e Sd ds Operoes

Registro de Bilheteria de Sala de Exibio

9.2.2.4 Formato e Contedo dos Dados de Entrada Vlido

9.3.1 Dados de Entrada

8.3.2.4 Formato dos Dados de Entrada Vlido

Consulta de Protocolos de um dia cinematogrfico

9.4.1 Dados de Entrada

Consulta de Situao de Adimplncia

9.5.1 Dados de Entrada

Certificao/Teste: Ambiente no qual os exibidores devero enviar um conjunto especfico de

Um relatrio de bilheteria sem sesses cinematogrficas: Esse relatrio demonstrar que o

1. Gerar token para o site de certificao

2. Token para o site de certificao

Funcionrio do Agente Exibidor

3. Registrar o token de certificao gerado no

Sistema de Informao do Agente Exibidor

7. Token para o site de produo

8. Registrar o token de produo gerado no Sistema

Sistema de Informao do Agente Exibidor

A. Gerao do Token de Certificao

c. Acessar a tela de gerao de tokens atravs do menu Outros Servios/Controle de

d. Clicar em Gerar Token e marcar a opo Certificao

C. Gerao do Token de Produo

c. Acessar a tela de gerao de tokens atravs do menu Outros Servios/Controle de

d. Clicar em Gerar Token e marcar a opo Produo (a opo Produo s estar

D. Envio dos Dados de Bilheteria de Produo

1. Estrutur de Ddos e Trnsmisso

b. Quem obrigado a enviar as informaes dirias de exibio para o

c. Sou obrigado a enviar os dados de bilheteria de todas as sesses?

d. A partir de quando o envio de informaes ao SCB passa a ser

e. Como fao para enviar minhas informaes de exibio diariamente?

f. Qual o prazo para o envio das informaes dirias de exibio?

g. Se tiver alguma sala sem registro, como devo proceder?

h. Como fao para corrigir e reenviar informaes que no foram aceitas

i. Quanto tempo tenho para retificar as informaes que foram enviadas

j. Recebi um e-mail com notificao de inadimplncia, o que devo fazer?

k. Se no consigo enviar as informaes porque o cdigo de alguma obra

l. O que acontece se enviarmos um relatrio de bilheteria sem gerar um

m. O que acontece se enviarmos um relatrio de bilheteria para o

2. Certifico dos Sistems

b. Existe um limite de relatrios de bilheteria que podemos enviar para

c. Podemos utilizar o ambiente de Certificao para testar nosso

d. Quando a verso do nosso sistema mudar ou caso troquemos de

Anexo I Mensgens ds Operoes

Anexo II Ctegoris de Ingressos

Anexo III Modliddes de Pgmentos

Das könnte Ihnen auch gefallen