Attestations
1 operação em Quadra Core API 0.5.0.
GET
/v1/attestationsList the CRC attestations of one accounting artifact
Every attestation of one artifact, newest first — superseded ones included. Each record names the CRC professional and firm, the act, the exact `subject_hash` it bound, and the journal entry (`journal_seq_no`) whose `evidence_hash` commits its `record_digest`.
⛔ Append-only: there is no update or delete verb for an attestation.
Raises: 400: INVALID_QUERY (unknown subject_kind)
Parâmetros
| Nome | Tipo | Detalhe |
|---|---|---|
| subject_kind | string | queryobrigatório PERIOD | FISCDOC | PIECE | RECLASSIFICATION |
| subject_id | string | queryobrigatório PERIOD/PIECE: '{scope_id}:{YYYY-MM}'; FISCDOC: the doc_id; RECLASSIFICATION: the obligation_id |
| cursor | string, opcional | query Opaque pagination cursor |
| limit | integer | query |
Respostas
| Status | Corpo | Detalhe |
|---|---|---|
| 200 | AttestationListResponse | Resposta bem-sucedida |
| 422 | HTTPValidationError | Erro de validação |
Esquemas
Os modelos que as operações acima aceitam e devolvem. Campos opcionais estão marcados como tal; um campo tipado como outro modelo está documentado sob o nome dele.
AttestationListResponse
A subject's attestations, newest first.
| Campo | Tipo | Detalhe |
|---|---|---|
| items | array de AttestationRecord | obrigatório |
| next_cursor | string, opcional | Page until null |
| subject_id | string | obrigatório |
| subject_kind | string | obrigatório |
AttestationRecord
One CRC professional's act on one artifact.
| Campo | Tipo | Detalhe |
|---|---|---|
| act | string | obrigatórioESCRITURACAO_ASSINADA | COMPETENCIA_APROVADA | RECLASSIFICACAO | CARTA_RESPONSABILIDADE | REABERTURA_AUTORIZADA |
| attestation_version | integer | obrigatório |
| attested_at | string | obrigatórioServer clock at the write (UTC) |
| attested_via | string | obrigatórioThe surface the act was performed on |
| crc_number | string | obrigatórioThe professional's CRC registration |
| crc_uf | string | obrigatórioThe UF of that registration |
| firm_cnpj | string | obrigatórioThe organização contábil — the contracting party |
| firm_crc | string | obrigatórioThe firm's own CRC registration |
| journal_hash | string | obrigatórioThat entry's journal_hash |
| journal_seq_no | integer | obrigatórioThe journal entry that commits record_digest |
| natureza_from | string, opcional | RECLASSIFICATION only: the prior natureza |
| natureza_to | string, opcional | RECLASSIFICATION only: the corrected natureza |
| professional_name | string | obrigatório |
| record_digest | string | obrigatóriosha256 over this record's fields — committed to the journal hash chain as the evidence_hash of entry journal_seq_no |
| seq | integer | obrigatório1-based, per subject; append-only |
| subject_hash | string | obrigatóriosha256 of the artifact exactly as attested — a canonical projection of the stored artifact, never of an API response |
| subject_id | string | obrigatórioPERIOD/PIECE: '{scope_id}:{YYYY-MM}'; FISCDOC: the doc_id; RECLASSIFICATION: the obligation_id |
| subject_kind | string | obrigatórioPERIOD | FISCDOC | PIECE | RECLASSIFICATION |
HTTPValidationError
| Campo | Tipo | Detalhe |
|---|---|---|
| detail | array de ValidationError |
ValidationError
| Campo | Tipo | Detalhe |
|---|---|---|
| ctx | object | |
| input | não declarado | |
| loc | array de string ou integer | obrigatório |
| msg | string | obrigatório |
| type | string | obrigatório |