changedOutput schema / properties / provenance / description
Previous value: -"Bloco de proveniência (contrato v1.1): fonte, URL, período, extração, diagnóstico de origem e licença"New value: +"Bloco de proveniência do portfólio: fonte, URL, período, extração, diagnóstico de origem e licença"
addedOutput schema / properties / provenance / properties / derivation_note
Added value: +{
+ "description": "O que o servidor calculou; presente junto com derived",
+ "type": "string"
+}
addedOutput schema / properties / provenance / properties / derived
Added value: +{
+ "description": "Presente (true) só quando o servidor calculou o valor — estatísticas, rankings, comparações — em vez de repassá-lo como veio do IBGE",
+ "type": "boolean"
+}
changedOutput schema / properties / provenance / properties / field_sources / description
Previous value: -"Proveniência por sub-fonte (contrato v1.2): presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"New value: +"Proveniência por sub-fonte: presente só quando a resposta junta partes extraídas de origens ou em momentos distintos, uma entrada por grupo de campos; ausente quando a resposta vem de uma única extração"
addedOutput schema / properties / provenance / properties / field_sources / items / description
Added value: +"Proveniência de um grupo de campos da resposta: de onde veio e quando foi extraído"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / data_vintage / description
Added value: +"Vintage/competência da sub-fonte"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / dataset_id / description
Added value: +"Identificador do conjunto da sub-fonte"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / fields / description
Added value: +"Campos do payload atribuídos a esta sub-fonte"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / retrieved_at / description
Added value: +"ISO-8601 da extração desta sub-fonte na origem"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / served_from_cache / description
Added value: +"true se esta sub-fonte veio do cache do servidor (retrieved_at é o da extração original); false se foi buscada nesta chamada; null se o servidor não distingue"
addedOutput schema / properties / provenance / properties / field_sources / items / properties / source_url / description
Added value: +"URL canônica da sub-fonte que originou estes campos"
addedOutput schema / properties / provenance / properties / notices
Added value: +{
+ "description": "Avisos que o IBGE publica junto com o dado (quebra de série, unidade, atualização), copiados como vieram; ausente quando não há aviso",
+ "items": {
+ "type": "string"
+ },
+ "minItems": 1,
+ "type": "array"
+}
changedOutput schema / properties / provenance / properties / retrieval / description
Previous value: -"Diagnóstico de origem desta chamada (contrato v1.1): idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"New value: +"Diagnóstico de origem desta chamada: idas à API do IBGE, tentativas somadas e anomalias contornadas; unstable=true quando houve anomalia. null quando nada foi medido (resposta servida só do cache)"
addedOutput schema / properties / provenance / properties / revision
Added value: +{
+ "additionalProperties": false,
+ "description": "Se o dado ainda pode mudar no IBGE: current = versão vigente na extração, que o IBGE pode revisar depois; provisional = preliminar; final = não muda mais. note traz o específico da fonte quando há",
+ "properties": {
+ "note": {
+ "description": "O específico da fonte: o que revisa, quando, por quê",
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "status": {
+ "description": "current = versão vigente, a fonte pode revisá-la; provisional = preliminar, incompleta ou sujeita a mudança (não compare como se fosse fechada); final = não muda mais, declarado pela fonte",
+ "enum": [
+ "current",
+ "provisional",
+ "final"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "status",
+ "note"
+ ],
+ "type": "object"
+}