--- title: "Cadastrar ou atualizar um estabelecimento comercial (CERC-AP001)" method: PUT path: "/estabelecimento" tags: ["Cadastro e atualização de estabelecimentos comerciais"] --- # Cadastrar ou atualizar um estabelecimento comercial (CERC-AP001) `PUT /estabelecimento` ## Request body - object[] - `tipoOperacao` 'C' | 'A', required — Identifica o tipo de operação correspondente àquela entrada, sendo:: - C = Criar novo estabelecimento comercial; - A = Atualizar estabelecimento comercial existente. - `referenciaExterna` string, 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] - `razaoSocial` string, required — Se PJ, preencher com a razão social do estabelecimento comercial. Se PF, preencher com o nome completo. - `nomeFantasia` string — 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] - `documentoUsuarioFinalRecebedor` string, 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 - `dataCredenciamento` string, date — Data de credenciamento do estabelecimento comercial, no formato AAAA-MM-DD. - `codigoMCC` string, 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. - `instituicaoCredenciadora` string — CNPJ da Instituição Credenciadora ou Subcredenciadora Participante. (14 dígitos alfanuméricos, completar com 0 à esquerda, se necessário.) - `contato` object, required — Dados de contato. - `nomeContato` string — Nome do contato do estabelecimento comercial. - `email` string, email, required — Email do contato do estabelecimento comercial. Caso não possua esta informação, enviar “N/D” para indicar que como não disponível. - `celular` string, required — Celular do contato do estabelecimento comercial. Informar DDD + Número de telefone. Caso não possua esta informação, enviar “N/D” para indicar que como não disponível. - `telefone` string — Telefone do contato do estabelecimento comercial. Informar DDD + Número de telefone. - `endereco` object — Dados do endereço. - `cep` string — CEP do endereço do estabelecimento comercial. Informar somente números, sem formatação. - `logradouro` string — Logradouro do estabelecimento comercial. - `numero` string — Número do endereço do estabelecimento comercial. - `complemento` string — Complemento do endereço do estabelecimento comercial. - `bairro` string — Bairro do estabelecimento comercial. - `cidade` string — Cidade do estabelecimento comercial. - `uf` string — Unidade de federação da localização do estabelecimento comercial. - `identificadorDosArranjos` object - `visa` string - `mastercard` string ## Response `207` Processamento de estabelecimentos comerciais realizado. Necessário consultar individualmente cada item para obter o status de processamento. - object[] - `protocolo` string — GUID ID de Protocolo gerado pela CERC, confirmando o recebimento da requisição - `referenciaExterna` string — Código de referência de controle do participante, para identificação nas próximas consultas relacionadas - `dataHoraProcessamento` string, 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. - `erros` Erro[] - `codigo` string — Código do erro - Consultar Tabela de Erro - `mensagem` string — Descrição do erro - Consultar Tabela de Erro ## Other responses - `400` — Tabela de Erros CÓDIGO|DESCRIÇÃO | |------|--------------------------------------------------| |101001|TIPO DE OPERACAO OBRIGATORIO | |101002|TIPO DE OPERACAO INVALIDO | |101003|REFERENCIA EXTERNA OBRIGATORIA | |101004|REFERENCIA EXTERNA JA EXISTE | |101005|RAZAO SOCIAL OBRIGATORIA | |101006|TIPO DOCUMENTO USUARIO FINAL RECEBEDOR OBRIGATORIO| |101007|TIPO DOCUMENTO USUARIO FINAL RECEBEDOR INVALIDO | |101008|USUARIO FINAL RECEBEDOR OBRIGATORIO | |101009|USUARIO FINAL RECEBEDOR JA EXISTE | |101010|CPF OU CNPJ DO USUARIO FINAL RECEBEDOR INVALIDO | |101011|STATUS OBRIGATORIO | |101012|STATUS INVALIDO | |101013|STATUS INVALIDO PARA A OPERACAO | |101014|BLOQUEIO DE LIQUIDACAO OBRIGATORIO | |101015|BLOQUEIO DE LIQUIDACAO INVALIDO | |101016|DATA DE CREDENCIAMENTO INVALIDA | |101017|CODIGO MCC OBRIGATORIO | |101018|CODIGO MCC INVALIDO | |101019|EMAIL OBRIGATORIO | |101020|EMAIL INVALIDO | |101021|CELULAR OBRIGATORIO | |101022|CELULAR INVALIDO | |101023|TELEFONE INVALIDO | |101024|CEP INVALIDO | |101025|UF INVALIDO | |101026|IDENTIFICADORES DE ARRANJO INVALIDOS | |101801|OPERACAO NAO PERMITIDA - ACESSO NEGADO | |101802|OPERACAO INVALIDA PARA O REGISTRO ATUAL | |101803|ERRO DEVIDO A ATUALIZACAO DE CAMPOS NAO PERMITIDOS| |101804|ERRO GENERICO DE VALIDACAO | |101901|LAYOUT INVALIDO | |101902|ENVIADO FORA DA GRADE HORARIA | |101903|NOME DO ARQUIVO JA ENVIADO | |101904|NOME DO ARQUIVO INVALIDO | |101999|ERRO INESPERADO | --- [API](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d.md) · [All operations](https://skmtc.net/cerc/apis/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cerc/receb-veis-de-arranjo-de-pagamento-institui-es-financeiras-d/revisions/98997c37ec38/schema)