# Atualiza as configurações fiscais padrão Atualiza as configurações fiscais padrão da empresa. Os IDs dos grupos devem existir e pertencer à empresa. O código CFOP deve ser um dos valores permitidos no enum. Endpoint: PUT /api/v3/tax-settings/defaults Version: 3.0.0 Security: OAuth2 ## Header parameters: - `CPlug-Company-Id` (number, required) Id da Empresa (Company). Você pode localizar os IDs das empresas no _endpoint_ de listagem de empresas. Example: 12 - `Idempotency-Key` (string, required) UUID aleatório gerado por você. Nós utilizamos esse header para evitar duplicidade de registros, ou seja, caso você não tenha recebido a resposta de alguma requisição e mandar o mesmo UUID, nós não duplicaremos o registro. ## Request fields (application/json): - `icms_group_id` (integer, required) ID do grupo de ICMS. Example: 68 - `ipi_group_id` (integer, required) ID do grupo de IPI. Example: 5 - `pis_cofins_group_id` (integer, required) ID do grupo de PIS/COFINS. Example: 2 - `issqn_group_id` (integer, required) ID do grupo de ISSQN. Example: 2 - `cfop_code` (string, required) Código do CFOP. Enum: "5101", "5102", "5103", "5104", "5115", "5405", "5656", "5667", "5933" ## Response 200 fields (application/json): - `data` (object) Representa as configurações fiscais padrão da empresa - `data.icms_group` (object) Identificador do grupo de ICMS. - `data.icms_group.id` (integer) ID do grupo de ICMS. Example: 6 - `data.icms_group.name` (string) Nome do grupo de ICMS. Example: "Grupo de ICMS 1" - `data.icms_group.tributary_group` (object) Representa um grupo tributário. - `data.icms_group.tributary_group.id` (integer) Identificador único do grupo tributário. Example: 900 - `data.icms_group.tributary_group.code` (string) Código do grupo tributário. Example: "900" - `data.icms_group.tributary_group.description` (string) Descrição do grupo tributário. Example: "900 - Outros" - `data.icms_group.icms_percentage` (number) Percentual do ICMS. - `data.icms_group.is_default` (boolean) Indica se é o grupo padrão. Example: true - `data.icms_group.is_shared_with_all_companies` (boolean) Indica se é compartilhado com todas as empresas. - `data.icms_group.created_at` (string) Data e hora de criação do registro. Example: "2025-08-28T18:05:17.000000Z" - `data.icms_group.updated_at` (string) Data e hora da última atualização do registro. Example: "2025-08-29T19:01:44.000000Z" - `data.ipi_group` (object) Identificador do grupo de IPI. - `data.ipi_group.id` (integer) ID do grupo de IPI. Example: 6 - `data.ipi_group.name` (string) Nome do grupo de IPI. Example: "Grupo de IPI 1" - `data.pis_cofins_group` (object) Identificador do grupo de PIS/COFINS. - `data.pis_cofins_group.id` (integer) ID do grupo de PIS/COFINS. Example: 6 - `data.pis_cofins_group.name` (string) Nome do grupo de PIS/COFINS. Example: "Grupo de PIS/COFINS 1" - `data.issqn_group` (object) Identificador do grupo de ISSQN. - `data.issqn_group.id` (integer) ID do grupo de ISSQN. Example: 6 - `data.issqn_group.name` (string) Nome do grupo de ISSQN. Example: "Grupo de ISSQN 1" - `data.cfop` (object) Representa um CFOP. - `data.cfop.code` (string) Código do CFOP. Example: "1101" - `data.cfop.description` (string) Descrição do CFOP. Example: "1101 - Compra para industrialização" ## Response 400 fields (application/json): - `code` (string, required) Código de erro. Example: "missing_headers" - `message` (string) Descrição do erro. Example: "error message" - `meta` (array) Dados adicionais sobre o erro. ## Response 422 fields (application/json): - `code` (string, required) Código de erro. Example: "uneditable_entity" - `message` (string) Descrição do erro. Example: "description error" - `meta` (array) Dados adicionais sobre o erro. - `meta.field` (string, required) Nome do campo no qual existe um erro de validação. Example: "name" - `meta.validations` (array) - `meta.validations.type` (string, required) Tipo da validação aplicada. Example: "Required" - `meta.validations.value` (array) Tipo de valor aplicável (esse campo pode ser vazio). ## Response 401 fields ## Response 403 fields