Junta Comercial do Estado de São Paulo (JUCESP)
JUCESP — Ficha completa (histórico de atos)
Quadro societário atual da JUCESP mais o histórico de atos arquivados na Junta.
Integração por API em construção. Esta consulta já roda hoje na plataforma, pela tela. O contrato abaixo é o que a API vai expor quando abrir.
Ficha
Estado medido agora, no mesmo lugar de onde a venda decide — não numa tabela mantida à parte.
- Identificador
- jucesp_completa
- Preço
- R$ 1,00
- Aceita
- CNPJ
- Esfera
- Estaduais
- Procedência
- Parceiro de integração
- Na plataforma
- Disponível
Parâmetros
O que a consulta exige para rodar. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.
| Parâmetro | Obrigatório | O que é |
|---|---|---|
| cnpj | Sim | CNPJ do alvo, 14 dígitos. |
| uf | Sim | Sigla da UF onde consultar. A cobertura varia por estado. |
Comportamento
O que esta fonte faz de diferente das outras — prazo, cobrança, repetição, recusa. Cada cláusula aqui saiu de um caso real que custou dinheiro; está publicada para que a sua integração não pague por ele de novo.
- Códigos reinterpretados Esta fonte reinterpreta pelo menos um código de retorno: o mesmo número significa coisas diferentes em origens diferentes.
Antes de integrar
Ressalvas sobre o que esta consulta é — e o que ela não é.
- Certificado digital Exige certificado digital do solicitante.
- Histórico de atos A ficha simples diz quem é sócio hoje; esta diz quem ERA e em que data saiu. Numa execução, a data da retirada do sócio é o que separa fraude à execução de saída regular.
- Só SP A JUCESP é a Junta Comercial de São Paulo: só arquiva ato de empresa registrada NESTE estado. Empresa de outra UF está na Junta do estado dela (JUCERJA, JUCEMG…), que esta consulta não alcança.
Códigos de retorno
A resposta HTTP é sempre 200; o resultado real está no campo code. A coluna de estorno faz parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.
| Classe | Códigos | O que significa | Estorna | Retenta |
|---|---|---|---|---|
| sucesso | 200 | A origem respondeu e entregou. | — | — |
| nao_encontrado | 612 | A origem respondeu: nada consta para este alvo. | Não | Não |
| indeterminado | 611 | A origem não conseguiu emitir pela internet. Não é irregularidade. | Não | Não |
| erro_participante | 608, 619, 620 | A origem recusou os DADOS do pedido. | Não | Sim |
| retry | 600, 605, 609, 610, 613, 614, 615, 618 | Instabilidade momentânea da origem ou do transporte. | Sim | Sim |
| fatal | 601, 602, 603, 604, 606, 607, 617, 621, 622 | Defeito de integração — nosso, não seu. | Sim | Não |
Permanentes: 602 e 603 não se curam sozinhos — a fonte sai do ar na hora e um humano é avisado.
Precisa desta consulta por API?
Diga qual volume você espera. A ordem de liberação segue a demanda real.
Falar sobre integração