❓ O que significa o erro 301 no padrão IPM?

Esse erro indica que algum campo do XML enviado está fora do padrão aceito pela prefeitura.

O provedor IPM geralmente retorna erro genérico quando:

• Um código numérico é enviado como texto
• Um campo obrigatório está fora do formato esperado
• Um valor monetário está com formatação incorreta
• Algum código interno da prefeitura não foi reconhecido
•  

🎯 Causa mais comum em São José/SC

🔎 Campo unidade_codigo enviado incorretamente

❌ Incorreto:

<unidade_codigo>UN</unidade_codigo>

✅ Correto:

<unidade_codigo>1</unidade_codigo>

A Prefeitura de São José exige código numérico, não sigla.

📌 Por que isso acontece?

O padrão IPM utiliza tabela interna de códigos de unidade, onde:

Se for enviada a sigla ("UN"), o sistema não reconhece e retorna erro 301.

🔎 Outras causas possíveis do erro 301

Caso a unidade esteja correta, verificar:

1️⃣ Telefone do tomador inválido

• DDD inexistente (ex.: 99 para SC)
• Telefone com caracteres especiais

• Quantidade de dígitos incorreta

   

Exemplo correto:

<ddd_fone_comercial>48</ddd_fone_comercial>
<fone_comercial>991490202</fone_comercial>

2️⃣ Valor monetário sem casas decimais

❌ Errado:

<valor>1850</valor>

✅ Correto:

<valor>1850,00</valor>

O padrão aceito deve seguir o mesmo formato do restante do XML.

3️⃣ Código de serviço incompatível com CNAE

Verificar se:

• O código de serviço está permitido para o CNAE do prestador.
• A alíquota está compatível com o regime tributário.
•  

🛠️ Como resolver o erro 301

1. Verificar campo <unidade_codigo> (deve ser numérico).
2. Conferir formatação de valores (duas casas decimais).
3. Validar telefone do tomador.
4. Reassinar o XML após qualquer alteração.

5. Reenviar para validação.

    

🚀 Boa prática recomendada

Para evitar esse erro no futuro:

• Implementar mapeamento de unidade por provedor (IPM usa código numérico).
• Criar validação pré-envio no sistema.

• Padronizar formatação monetária automaticamente.

   

📌 Resumo

Se aparecer:

Código 301 – Parâmetros inválidos para a requisição

👉 Primeira coisa a verificar em São José/SC (IPM):
<unidade_codigo> deve ser 1 e não UN.