HISTÓRICO

ÍNDICE

• Introdução
• Integração por API
• Resultado do processamento

Introdução

Esse material apresenta as explicações para as transmissões de cargas das centrais CEP, CESDI e RCTO da CENSEC por meio de API diretamente do sistema do cartório. 

O envio das cargas por API é o meio mais recomendável, pois agiliza o processo para o cartório e evita intervenções manuais. Entretanto, se o cartório não tiver um sistema estruturado, poderá enviar as cargas por outros meios, tais como, importação de arquivo XML ou TXT na tela da CENSEC ou mesmo digitação dos atos.

Integração por API

A sistemática de envio por API basicamente compõe os seguintes passos:

1. Formatação pelo sistema do cartório de um arquivo XML com os dados dos atos notariais
2. Obtenção do Base64 do arquivo XML gerado
3. Execução da API /api/cargas/upload, informando a quinzena que se refere(m) o(s) ato(s) e o Base64 do arquivo XML
4. Conferência do resultado de processamento na tela da CENSEC
5. Após o envio de todos os atos da quinzena, o responsável do cartório deve efetuar o fechamento, conforme procedimentos de cada Central CEP, CESDI e RCTO, 

Para executar a API de transmissão dos atos à CENSEC, cada cartório deverá obter a chave de integração (x-api-key), conforme instruções desse link AQUI.

Atentem-se trocar o endpoint de execução da API, além da chave de integração,  conforme o ambiente da CENSEC:
- Homologação: https://censec-hml.notariado.org.br
- Produção: https://censec.org.br

RECOMENDAÇÂO DE TRANSMISSÃO: Execute a API a cada ato gerado no sistema do cartório ou envie um lote diário. Com isto, as consultas na CENSEC tornarão mais confiáveis para todos, pois os atos subsequentes de procuração e escrituras, a saber, renúncias, revogações, substabelecimentos, serão informados quase de imediato ao sistema.

Exemplo com url de homologação

Request:
 curl --location --request POST 'https://censec-hml.notariado.org.br/api/cargas/upload' \
--header 'x-api-key: your-app|xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' \
--header 'Content-Type: application/json' \
--data-raw '{
"central": "Cep",
"quinzena": { "anoReferencia": 2023, "quinzenaReferencia": 2, "mesReferencia": "07" },
"arquivo": "base64 do XML"
}
 }' 

Response:

"carga": {

        "id": "71e50064-8e2b-4666-bbbb-x7fccf900bd9",

        "status": "AguardandoValidacao",

        "referencia": "C055611",

        "dataInclusao": "2023-08-07T17:54:00.8006021+00:00",

        "tipo": "Xml",

        "lote": {

            "dataFechamento": null,

            "encarregadoFechamentoId": null,

            "cartorioId": "6c0e766e-5302-4208-b6fc-14bea8ee2ed8",

            "cartorio": {

                "parentId": "00000000-0000-0000-0000-000000000000",

                "municipio": {

                    "nome": "BRASÍLIA",

                    "id": "b47b0dd2-3592-4a07-91f6-016d171aea06",

                    "parentId": "00000000-0000-0000-0000-000000000000",

                    "uf": "DF",

                    "ibge": null

                },

                "endereco": {

                    "logradouro": "CENTRO EMPRESARIAL VARIG, SETOR COMERCIAL NORTE, QUADRA 4, BLOCO B",

                    "numero": "SN",

                    "complemento": "Sala 204",

                    "bairro": "Asa Norte",

                    "cep": "70714020"

                },

                "titular": {

                    "cpf": "99998888877",

                    "rg": null,

                    "ufs": null,

                    "id": "14a8c650-387f-4403-a149-d0ad5f811a61",

                    "subject": "734a2f35-246c-42d3-ab61-0f103d801941",

                    "name": "Carlos Palmeiras",

                    "emailAddress": "cartorio@notariado.org.br",

                    "parentId": null,

                    "rootRoles": [],

                    "parentRootRoles": null,

                    "subscriptions": []

                },

                "nomeTitularCnj": null,

                "email": "tabeliao@notariado.org.br",

                "telefones": [

                    {

                        "telefone": "6137727800",

                        "ramal": "",

                        "contato": "",

                        "tipo": "Fixo",

                        "publico": true

                    }

                ],

                "cnsOld": null,

                "dataInicio": "2020-05-31T15:00:00",

                "dataDesativacao": null,

                "competenciasCartorio": [

                    "ConsultarRcto",

                    "CargaRcto",

                    "ConsultarCep",

                    "CargaCep",

                    "ConsultarCesdi",

                    "CargaCesdi",

                    "ConsultarCnsip",

                    "CadastroCnsip"

                ],

                "isHomolog": false,

                "id": "6c0e766e-5302-4208-b6fc-14bea8ee2ed8",

                "cns": 991000,

                "nome": "100º Tabelionato de Notas",

                "nomeCompleto": "100º Tabelionato de Notas",

                "nomeFormatado": "100º Tabelionato de Notas  - BRASÍLIA/DF",

                "acessoHabilitado": true,

                "nomeMunicipio": "BRASÍLIA",

                "uf": "DF",

                "atribuicoes": [

                    "Notas"

                ]

            },

            "id": "71dbc268-1f84-46ea-b6ba-9zbf74ee0422",

            "status": "Aberto",

            "periodoInicio": {

                "anoReferencia": 2023,

                "quinzenaReferencia": 2,

                "mesReferencia": "Julho",

                "primeiroDia": "2023-07-16T00:00:00",

                "ultimoDia": "2023-07-31T00:00:00"

            },

            "periodoFim": {

                "anoReferencia": 2023,

                "quinzenaReferencia": 2,

                "mesReferencia": "Julho",

                "primeiroDia": "2023-07-16T00:00:00",

                "ultimoDia": "2023-07-31T00:00:00"

            },

            "numeroAtos": -1,

            "tipo": "Cep",

            "referencia": "C044334",

            "podeSerFechado": true

        },

        "possuiBlobDeErro": false

    },

    "success": true,

    "fileFormatError": null,

    "validationResults": []

}

Resultado do processamento

Para conferir o resultado o resultado das cargas, acesse o sistema com seu certificado digital e clique em Cargas na Central correspondente ao arquivo transmitido.

Localize nas logs de processamento o status de execução da carga. 

A listagem de execuções é apresentada em ordem de período de referência

Se a carga for reprovada, poderá clicar sobre o ícone de detalhamento dos erros.