diff --git a/FiscalAPI.postman_collection.json b/FiscalAPI.postman_collection.json index 43e6433..f16dd95 100644 --- a/FiscalAPI.postman_collection.json +++ b/FiscalAPI.postman_collection.json @@ -978,10 +978,22 @@ { "key": "cnpj", "value": "12345678000195" + }, + { + "key": "cpf", + "value": "12345678909", + "description": "CPF do titular (no lugar de `cnpj`). Exige `data_nascimento`.", + "disabled": true + }, + { + "key": "data_nascimento", + "value": "12/04/1985", + "description": "Data de nascimento do titular do CPF (DD/MM/AAAA ou AAAA-MM-DD). Obrigatória para CPF.", + "disabled": true } ] }, - "description": "Certidão de débitos relativos a tributos federais e à Dívida Ativa da União.\n\n- Já existe certidão válida por mais de 3 dias: devolve essa certidão (`modo: consulta`).\n- Não existe, ou vence em até 3 dias: emite uma nova (`modo: emissao`).\n- `emitir_nova=true`: emite sempre uma nova.\n\nPor enquanto, somente **CNPJ** (consultas por CPF voltam `status: erro`, sem cobrança).\n\nA emissão pode levar até cerca de 60 s. Se não ficar pronta, a resposta é HTTP 200 com `source_status.error_code = EM_PROCESSAMENTO` e o header `Retry-After`: consulte de novo depois do tempo indicado (não dispara outra emissão e não é cobrado).\n\n**Cobrança:** 1 crédito por consulta com dado. Erros (HTTP 4xx/5xx ou `source_status.status` diferente de `success`) não são cobrados. Respostas de cache (`cached: true`) cobram normalmente.\n\nDocumentação: https://docs.fiscalapi.com.br/docs/certidoes-federais/consultar-cnd-federal" + "description": "Certidão de débitos relativos a tributos federais e à Dívida Ativa da União.\n\n- Já existe certidão válida por mais de 3 dias: devolve essa certidão (`modo: consulta`).\n- Não existe, ou vence em até 3 dias: emite uma nova (`modo: emissao`).\n- `emitir_nova=true`: emite sempre uma nova.\n\nAceita **CNPJ** ou **CPF**. Para CPF, envie também `data_nascimento` (DD/MM/AAAA ou AAAA-MM-DD): a Receita não emite sem ela. CPF sem a data, ou com data que não confere com a Receita, volta `status: erro`, sem cobrança. Para testar por CPF, desmarque `cnpj` e marque `cpf` e `data_nascimento`.\n\nA emissão pode levar até cerca de 60 s. Se não ficar pronta, a resposta é HTTP 200 com `source_status.error_code = EM_PROCESSAMENTO` e o header `Retry-After`: consulte de novo depois do tempo indicado (não dispara outra emissão e não é cobrado).\n\n**Cobrança:** 1 crédito por consulta com dado. Erros (HTTP 4xx/5xx ou `source_status.status` diferente de `success`) não são cobrados. Respostas de cache (`cached: true`) cobram normalmente.\n\nDocumentação: https://docs.fiscalapi.com.br/docs/certidoes-federais/consultar-cnd-federal" }, "response": [ { diff --git a/openapi-publico.json b/openapi-publico.json index cf25896..733d239 100644 --- a/openapi-publico.json +++ b/openapi-publico.json @@ -925,7 +925,7 @@ "Certidoes Federais" ], "summary": "Consultar CND Federal (RF+PGFN)", - "description": "Consulta Certidao Negativa de Debitos relativos a Tributos Federais e a Divida Ativa da Uniao (Receita Federal + PGFN). Se o contribuinte ja tem certidao que vale por mais de 3 dias, devolve essa (`modo=consulta`); se nao tem, emite uma nova (`modo=emissao`). Com `emitir_nova=true`, emite sempre.", + "description": "Consulta Certidao Negativa de Debitos relativos a Tributos Federais e a Divida Ativa da Uniao (Receita Federal + PGFN). Se o contribuinte ja tem certidao que vale por mais de 3 dias, devolve essa (`modo=consulta`); se nao tem, emite uma nova (`modo=emissao`). Com `emitir_nova=true`, emite sempre. Para CPF, informe tambem `data_nascimento`: a Receita nao emite sem ela.", "operationId": "consultar_cnd_federal_api_consultar_cnd_federal_get", "parameters": [ { @@ -961,6 +961,18 @@ "title": "Emitir Nova" }, "description": "Emite uma certidao nova mesmo que o contribuinte ja tenha uma valida." + }, + { + "name": "data_nascimento", + "in": "query", + "required": false, + "schema": { + "type": "string", + "description": "Data de nascimento do titular do CPF (DD/MM/AAAA ou AAAA-MM-DD). Obrigatoria para CPF.", + "default": "", + "title": "Data Nascimento" + }, + "description": "Data de nascimento do titular do CPF (DD/MM/AAAA ou AAAA-MM-DD). Obrigatoria para CPF." } ], "responses": { @@ -2200,7 +2212,7 @@ "CT-e XML" ], "summary": "Consultar XML de CT-e por chave, com certificado", - "description": "Retorna o XML completo de UM CT-e, CT-e OS ou GTV-e a partir da chave de acesso (44 posicoes; aceita CNPJ alfanumerico do emitente), usando o certificado digital do cliente (e-CPF/e-CNPJ) enviado na requisicao. O certificado NAO e armazenado. So retorna o documento quando o titular do certificado e participante. Cobra so quando retorna XML, no mesmo valor do XML de NF-e com certificado. Chave sem XML nao e cobrada.", + "description": "Retorna o XML completo de UM CT-e, CT-e OS ou GTV-e a partir da chave de acesso (44 posicoes; aceita CNPJ alfanumerico do emitente), usando o certificado digital do cliente (e-CPF/e-CNPJ) enviado na requisicao. O certificado NAO e armazenado. So retorna o documento quando o titular do certificado e participante. Cobra so quando retorna XML, de R$ 0,05 (Enterprise) a R$ 0,30 (Starter) por CT-e. Chave sem XML nao e cobrada.", "operationId": "consultar_cte_xml_endpoint_api_consultar_cte_xml_post", "requestBody": { "required": true,