Overview
We are rolling out an essential update to the CNPJ field to ensure your operations comply with the new Brazilian federal regulations taking effect in June 2026.
This change focuses on data integrity and improves how information is validated and processed across our API, integrations, and user interface (UI).
What’s new?
1. Strict API and integration validation
The CNPJ field will no longer accept mixed inputs (e.g., text alongside the document number). Moving forward, any input that does not follow the strict document format will trigger an INVALID_INPUT error.
2. New UI mask application
The field display within the platform will now follow the updated regulatory format. Legacy records containing mixed data will not be deleted but may show visual inconsistencies when the new mask is applied.
Recommendations
If your integrations or automations currently use the CNPJ field to store auxiliary information (such as "Pending" status or notes), these requests will fail after the update. We recommend:
- Payload review: ensure your integrations send strictly the document number.
- Data segregation: move auxiliary text to dedicated Text or Label fields.
Release date for the adaptation to the new format
The releases will be phased in, starting on April 1, 2026, and scheduled to be completed on May 15, 2026.