v1

latestOpenAPI 3.1.12026-07-2371254470.9 KB
Cadastro e atualização de estabelecimentos comerciais

Cadastrar ou atualizar um estabelecimento comercial (CERC-AP001)

put/estabelecimento

Request body

tipoOperacao'C' | 'A' required

Identifica o tipo de operação correspondente àquela entrada, sendo::

  • C = Criar novo estabelecimento comercial;
  • A = Atualizar estabelecimento comercial existente.
referenciaExternastring required

Código de referência único (exclusivo) de controle do participante, para identificação nas próximas transações relacionadas. [Não atualizável]

razaoSocialstring required

Se PJ, preencher com a razão social do estabelecimento comercial. Se PF, preencher com o nome completo.

nomeFantasiastring

Nome fantasia do estabelecimento comercial.

tipoDocumentoUsuarioFinalRecebedor'1' | '2' required

Identificador do tipo de documento do usuário final recebedor, sendo:

  • 1 = CPF
  • 2 = CNPJ

[Não atualizável]

documentoUsuarioFinalRecebedorstring required

Número do documento CNPJ ou CPF do usuário final recebedor. 14 dígitos para CNPJ e 11 dígitos para CPF e completar com 0 à esquerda, se necessário.

[Não atualizável]

tipoUsuarioFinalRecebedor'1' | '2' | '3' required

Código do tipo de usuário final recebedor, sendo:

  • 1 = Estabelecimento comercial
  • 2 = Subcredenciadora
  • 3 = Ambos (Estabelecimento comercial + Subcredenciadora)

[Não atualizável]

status'1' | '2' | '3' required

Status do estbelecimento comercial:

  • 1 = Ativo: Estabelecimento Comercial está apto a transacionar
  • 2 = Inativo: Estabelecimento Comercial está inapto a transacionar e não possui agenda futura
  • 3 = Suspenso: Estabelecimento Comercial está inapto a transacionar e possui agendas futuras
bloqueioLiquidacao'0' | '1' required

A liquidação do estabelecimento comercial está bloqueada. Informações aceitas:

  • 0 = Não
  • 1 = Sim
dataCredenciamentostring date

Data de credenciamento do estabelecimento comercial, no formato AAAA-MM-DD.

codigoMCCstring required

MCC de atividade do estabelecimento comercial. Caso não possua esta informação, enviar “N/D” para indicar que como não disponível.

instituicaoCredenciadorastring

CNPJ da Instituição Credenciadora ou Subcredenciadora Participante. (14 dígitos alfanuméricos, completar com 0 à esquerda, se necessário.)

Response

Processamento de estabelecimentos comerciais realizado. Necessário consultar individualmente cada item para obter o status de processamento.

protocolostring

GUID ID de Protocolo gerado pela CERC, confirmando o recebimento da requisição

referenciaExternastring

Código de referência de controle do participante, para identificação nas próximas consultas relacionadas

dataHoraProcessamentostring date-time

Data/hora da requisição

status'0' | '1'

Tipo de conta onde o pagamento será liquidado:

  • 0 = Pedido processado com sucesso.
  • 1 = Pedido processado com erro.