---
updatedAt: 2026-04-21T06:16:37.000Z
agentTools:
  projectIndex: https://b2brouter.readme.io/llms.txt
---

# Update a tax report setting

This endpoint updates a tax report setting associated with an account.


# OpenAPI definition

````json
{
  "openapi": "3.0.1",
  "info": {
    "title": "B2Brouter API",
    "description": "The B2Brouter API allows you to send and receive electronic documents.",
    "version": "2026-06-26",
    "contact": {
      "name": "Service Delivery Team",
      "email": "servicedelivery@b2brouter.net"
    }
  },
  "servers": [
    {
      "url": "https://api-staging.b2brouter.net",
      "description": "Test server"
    },
    {
      "url": "https://api.b2brouter.net",
      "description": "Production server"
    }
  ],
  "tags": [
    {
      "name": "Tax Report Settings",
      "description": "Related to tax report settings"
    }
  ],
  "paths": {
    "/accounts/{account}/tax_report_settings/{code}": {
      "put": {
        "operationId": "put-tax-report-setting",
        "tags": [
          "Tax Report Settings"
        ],
        "summary": "Update a tax report setting",
        "description": "This endpoint updates a tax report setting associated with an account.\n",
        "parameters": [
          {
            "$ref": "#/components/parameters/api_version_header"
          },
          {
            "$ref": "#/components/parameters/account"
          },
          {
            "$ref": "#/components/parameters/tax_authority_code"
          }
        ],
        "requestBody": {
          "description": "The tax report setting object in format JSON to update",
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "tax_report_setting"
                ],
                "properties": {
                  "tax_report_setting": {
                    "anyOf": [
                      {
                        "$ref": "#/components/schemas/VerifactuTaxReportSetting"
                      },
                      {
                        "$ref": "#/components/schemas/TbaiTaxReportSetting"
                      },
                      {
                        "$ref": "#/components/schemas/SdiTaxReportSetting"
                      },
                      {
                        "$ref": "#/components/schemas/LhdnTaxReportSetting"
                      },
                      {
                        "$ref": "#/components/schemas/KsefTaxReportSetting"
                      },
                      {
                        "$ref": "#/components/schemas/DgfipTaxReportSetting"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful operation",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "tax_report_setting": {
                      "oneOf": [
                        {
                          "$ref": "#/components/schemas/VerifactuTaxReportSetting"
                        },
                        {
                          "$ref": "#/components/schemas/TbaiTaxReportSetting"
                        },
                        {
                          "$ref": "#/components/schemas/SdiTaxReportSetting"
                        },
                        {
                          "$ref": "#/components/schemas/LhdnTaxReportSetting"
                        },
                        {
                          "$ref": "#/components/schemas/KsefTaxReportSetting"
                        },
                        {
                          "$ref": "#/components/schemas/DgfipTaxReportSetting"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableEntity"
          }
        },
        "security": [
          {
            "api_key": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "api_key": {
        "type": "apiKey",
        "description": "API Key of your account",
        "name": "X-B2B-API-Key",
        "in": "header"
      }
    },
    "parameters": {
      "api_version_header": {
        "name": "X-B2B-API-Version",
        "in": "header",
        "description": "Specifies the version of the API to use in this request. If not specified uses the API-Version set in the group conifguration\nB2Brouter UI Application -> Developers -> API Keys -> API Version\n",
        "required": false,
        "schema": {
          "type": "string",
          "example": "2026-06-26",
          "default": "2026-06-26"
        }
      },
      "account": {
        "name": "account",
        "in": "path",
        "description": "Account identifier (ID)",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "my-account"
      },
      "tax_authority_code": {
        "name": "code",
        "description": "Code of tax report setting",
        "in": "path",
        "required": true,
        "schema": {
          "type": "string",
          "example": "verifactu",
          "enum": [
            "tbai",
            "sdi",
            "lhdn",
            "verifactu",
            "ksef",
            "dgfip"
          ]
        }
      }
    },
    "schemas": {
      "Error": {
        "type": "object",
        "description": "Represents an error object returned in a failed request",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "A unique error code identifying the type of error. See https://developer.b2brouter.net/docs/error_codes for the full code list.",
                "example": "parameter_empty"
              },
              "message": {
                "type": "string",
                "description": "A human-readable error message providing more context about the error.",
                "example": "The parameter 'param' is missing or the value is empty"
              },
              "param": {
                "type": "string",
                "description": "The parameter in the request that caused the error (if applicable).",
                "example": "param"
              },
              "type": {
                "type": "string",
                "description": "The type of error. Currently the only possible value is \"invalid_request_error\".",
                "example": "invalid_request"
              }
            }
          }
        }
      },
      "UnauthorizedError": {
        "type": "object",
        "description": "Represents an error object returned in a failed request",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "A unique error code identifying the type of error.",
                "example": "unauthorized",
                "default": "unauthorized"
              },
              "message": {
                "type": "string",
                "description": "A human-readable error message providing more context about the error.",
                "example": "Invalid API Key provided, or the API key might not have the necessary permissions for this action."
              },
              "type": {
                "type": "string",
                "description": "The type of error, often mirrors the error code for clarity.",
                "example": "invalid_request_error",
                "default": "invalid_request_error"
              }
            }
          }
        }
      },
      "ForbiddenError": {
        "type": "object",
        "description": "Represents an error object returned when the target project is archived",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "A unique error code identifying the type of error.",
                "example": "403",
                "default": "403"
              },
              "message": {
                "type": "string",
                "description": "A human-readable error message providing more context about the error.",
                "example": "The project you are trying to access has been archived."
              },
              "type": {
                "type": "string",
                "description": "The type of error, often mirrors the error code for clarity.",
                "example": "invalid_request_error",
                "default": "invalid_request_error"
              }
            }
          }
        }
      },
      "TbaiTaxReportSetting": {
        "type": "object",
        "description": "Represents a tax report settings for 'tbai' as an object",
        "properties": {
          "code": {
            "type": "string",
            "example": "tbai",
            "description": "The Tax Report Authority code.",
            "enum": [
              "tbai"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2024-07-09T00:00:00.000Z",
            "description": "Date when the Tax Report Setting was enabled. If not provided, the current date and time will be used..",
            "nullable": true
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "delegation": {
            "type": "string",
            "example": "gipuzkoa",
            "description": "Tax Authority Delegation.",
            "enum": [
              "gipuzkoa",
              "bizkaia",
              "araba"
            ]
          },
          "reason_vat_exempt": {
            "type": "string",
            "example": "E1",
            "description": "TicketBAI Reason for VAT Exempt.",
            "enum": [
              "E1",
              "E2",
              "E3",
              "E4",
              "E5",
              "E6"
            ],
            "nullable": true
          },
          "special_regime_key": {
            "type": "string",
            "example": "01",
            "description": "TicketBAI Special Regime Key.",
            "enum": [
              "01",
              "02",
              "03",
              "04",
              "05",
              "06",
              "07",
              "08",
              "09",
              "10",
              "11",
              "12",
              "13",
              "14",
              "15",
              "51",
              "52",
              "53"
            ],
            "nullable": true
          },
          "reason_no_subject": {
            "type": "string",
            "example": "OT",
            "description": "Default TicketBAI Reason for No Subject.",
            "enum": [
              "OT",
              "RL"
            ],
            "nullable": true
          },
          "credit_note_code": {
            "type": "string",
            "example": "R1",
            "description": "Default TicketBAI Credit Note Code.",
            "enum": [
              "R1",
              "R2",
              "R3",
              "R4",
              "R5"
            ],
            "nullable": true
          },
          "type_operation": {
            "type": "string",
            "example": "services",
            "description": "Default TicketBAI Type of Operation.",
            "enum": [
              "services",
              "goods"
            ],
            "nullable": true
          },
          "epigraph": {
            "type": "string",
            "example": "147410",
            "description": "TicketBAI Epigraph needed for bizkaia delegation.",
            "nullable": true
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was updated",
            "readOnly": true
          }
        }
      },
      "SdiTaxReportSetting": {
        "type": "object",
        "description": "Represents a tax report settings for 'sdi' as an object",
        "properties": {
          "code": {
            "type": "string",
            "example": "sdi",
            "description": "The Tax Report Authority code.",
            "enum": [
              "sdi"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was enabled",
            "nullable": true
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was last updated",
            "readOnly": true
          }
        }
      },
      "VerifactuTaxReportSetting": {
        "type": "object",
        "description": "Represents a tax report settings for Verifactu as an object",
        "properties": {
          "code": {
            "type": "string",
            "example": "verifactu",
            "description": "The Tax Report Authority code.",
            "enum": [
              "verifactu"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2025-04-29T00:00:00.000Z",
            "description": "Date when the Tax Report Setting was enabled. If not provided, the current date and time will be used.",
            "nullable": true
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "reason_vat_exempt": {
            "type": "string",
            "example": "E1",
            "description": "Verifactu reason code for VAT Exemption. \n[Verifactu codes](https://developer.b2brouter.net/docs/verifactu#exemption-codes).\n",
            "enum": [
              "E1",
              "E2",
              "E3",
              "E4",
              "E5",
              "E6"
            ],
            "nullable": true
          },
          "special_regime_key": {
            "type": "string",
            "example": "01",
            "description": "Verifactu Special Regime Key.\n[Verifactu codes](https://developer.b2brouter.net/docs/verifactu#special-regime-key-codes).\n",
            "enum": [
              "01",
              "02",
              "03",
              "04",
              "05",
              "06",
              "07",
              "08",
              "09",
              "10",
              "11",
              "14",
              "15",
              "17",
              "18",
              "19"
            ],
            "nullable": true
          },
          "special_regime_key_igic": {
            "type": "string",
            "example": "01",
            "description": "Verifactu Special Regime Key for IGIC tax.",
            "enum": [
              "01",
              "02",
              "03",
              "04",
              "05",
              "06",
              "07",
              "08",
              "09",
              "10",
              "11",
              "14",
              "15",
              "17",
              "18",
              "19",
              "20"
            ],
            "nullable": true
          },
          "reason_no_subject": {
            "type": "string",
            "example": "N1",
            "description": "Verifactu Reason for No Subject.\n[Verifactu codes](https://developer.b2brouter.net/docs/verifactu#non-subject-codes)\n",
            "enum": [
              "N1",
              "N2"
            ],
            "nullable": true
          },
          "credit_note_code": {
            "type": "string",
            "example": "R1",
            "description": "Verifactu Credit Note Code.\n[Verifactu codes](https://developer.b2brouter.net/docs/verifactu#invoice-type-codes)\n",
            "enum": [
              "R1",
              "R2",
              "R3",
              "R4",
              "R5"
            ],
            "nullable": true
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was updated",
            "readOnly": true
          }
        }
      },
      "KsefTaxReportSetting": {
        "type": "object",
        "description": "Represents a tax report settings for 'KSeF (Krajowy System e-Faktur)' as an object",
        "properties": {
          "code": {
            "type": "string",
            "example": "ksef",
            "description": "The Tax Report Authority code.",
            "enum": [
              "ksef"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2024-07-09T00:00:00.000Z",
            "description": "Date when the Tax Report Setting was enabled. If not provided, the current date and time will be used..",
            "nullable": true
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "credit_note_code": {
            "type": "string",
            "example": "1",
            "enum": [
              "1",
              "2",
              "3"
            ],
            "nullable": false,
            "description": "Default type of effect of correction in the records for VAT:\n* `1` - Correction with effect on the date of recognition of the original invoice.\n* `2` - Correction with effect on the date of issue of the corrective invoice.\n* `3` - Correction with effect on a different date, including when the dates are different for different items of the corrective invoice.\n\nThis setting applies to invoices with type codes KOR, KOR_ZAL, or KOR_ROZ. When creating a corrective invoice,\nyou must also specify the `amended_ksef_number` field in the TaxReport with the KSeF reference number of the original invoice.\n"
          },
          "type_operation": {
            "type": "string",
            "example": "services",
            "description": "Default type of Operation.",
            "enum": [
              "services",
              "goods",
              null
            ],
            "nullable": true
          },
          "certificate": {
            "type": "string",
            "format": "byte",
            "description": "KSeF certificate encoded in base64 (without line breaks). Two formats are accepted:\n\n- **PKCS#12** (`.p12` / `.pfx`): a single file containing both the certificate and the private key.\n  Send it alone, with its password in `certificate_pin`.\n- **PEM certificate** (`.crt` / `.pem`), as issued by the KSeF certificate module (MCU).\n  Send it together with its private key in `certificate_key`.\n\n**How to encode your file:**\n```bash\nbase64 -w 0 your-certificate.p12   # or your-certificate.crt\n```\n",
            "example": "MIIKZAIBAzCCCh4GCSqGSIb3DQEHAaCCCg8EggoLMIIKBzCCBXcGCSqGSIb3...",
            "nullable": false,
            "writeOnly": true
          },
          "certificate_key": {
            "type": "string",
            "format": "byte",
            "description": "Private key in PEM format (`.key` / `.pem`) encoded in base64 (without line breaks). RSA and EC keys are supported.\n\nOnly used when `certificate` is a PEM certificate (`.crt` / `.pem`); must not be sent with a PKCS#12 certificate.\nIf the key is encrypted, send its password in `certificate_pin`.\n\n**How to encode your key:**\n```bash\nbase64 -w 0 your-private-key.key\n```\n",
            "example": "LS0tLS1CRUdJTiBFTkNSWVBURUQgUFJJVkFURSBLRVktLS0tLQpNSUlGSFRCWEJna3Fo...",
            "nullable": false,
            "writeOnly": true
          },
          "certificate_pin": {
            "type": "string",
            "description": "Password that protects the certificate:\n\n- With a **PKCS#12** certificate: the password of the `.p12` / `.pfx` file. Required.\n- With a **PEM certificate + `certificate_key`**: the password of the private key.\n  Required only if the key is encrypted; omit it for an unencrypted key.\n",
            "example": "MySecurePassword123",
            "nullable": false,
            "writeOnly": true
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was updated",
            "readOnly": true
          }
        }
      },
      "DgfipTaxReportSetting": {
        "type": "object",
        "description": "[BETA] Represents a tax report settings for DGFiP (France) as an object",
        "required": [
          "start_date",
          "type_operation"
        ],
        "properties": {
          "code": {
            "type": "string",
            "example": "dgfip",
            "description": "The Tax Report Authority code.",
            "enum": [
              "dgfip"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2025-04-29T00:00:00.000Z",
            "description": "Date when the Tax Report Setting was enabled. If not provided, the current date and time will be used."
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "type_operation": {
            "type": "string",
            "example": "services",
            "description": "Default DGFiP Type of Operation.",
            "enum": [
              "services",
              "goods",
              "mixed"
            ]
          },
          "reason_vat_exempt": {
            "type": "string",
            "example": "VATEX-FR-FRANCHISE",
            "description": "DGFiP reason code for VAT Exemption (BT-121).\nRequired when invoice contains exempt tax lines (category E).\nDefaults to VATEX-FR-FRANCHISE if not specified.\n",
            "enum": [
              "VATEX-FR-FRANCHISE",
              "VATEX-FR-CNWVAT",
              "VATEX-FR-CGI261-1",
              "VATEX-FR-CGI261-2",
              "VATEX-FR-CGI261-3",
              "VATEX-FR-CGI261-4",
              "VATEX-FR-CGI261-5",
              "VATEX-FR-CGI261-7",
              "VATEX-FR-CGI261-8",
              "VATEX-FR-CGI261A",
              "VATEX-FR-CGI261B",
              "VATEX-FR-CGI261C-1",
              "VATEX-FR-CGI261C-2",
              "VATEX-FR-CGI261C-3",
              "VATEX-FR-CGI261D-1",
              "VATEX-FR-CGI261D-1BIS",
              "VATEX-FR-CGI261D-2",
              "VATEX-FR-CGI261D-3",
              "VATEX-FR-CGI261D-4",
              "VATEX-FR-CGI261E-1",
              "VATEX-FR-CGI261E-2",
              "VATEX-FR-CGI277A",
              "VATEX-FR-CGI275",
              "VATEX-FR-298SEXDECIESA",
              "VATEX-FR-CGI295",
              "VATEX-FR-AE",
              null
            ],
            "nullable": true
          },
          "enterprise_size": {
            "type": "string",
            "example": "pme",
            "description": "Enterprise size category as defined by French LME 2008 law (Décret 2008-1354).\nDetermines the e-invoicing obligation timeline.\n- `ge` — Grande entreprise (≥ 5000 employees or revenue > €1.5B)\n- `eti` — Entreprise de taille intermédiaire (250–4999 employees, revenue ≤ €1.5B)\n- `pme` — Petite et moyenne entreprise (10–249 employees, revenue ≤ €50M)\n- `micro` — Micro-entreprise (< 10 employees, revenue ≤ €2M)\n",
            "enum": [
              "ge",
              "eti",
              "pme",
              "micro",
              null
            ],
            "nullable": true
          },
          "naf_code": {
            "type": "string",
            "example": "62",
            "description": "First two digits of the company's NAF/APE code (INSEE activity classification).\nMust be exactly 2 digits. For example, `62` corresponds to \"Programmation, conseil\net autres activités informatiques\".\n",
            "pattern": "^\\d{2}$",
            "nullable": true
          },
          "email": {
            "type": "string",
            "example": "contact@company.fr",
            "description": "Contact email address for DGFiP notifications.",
            "nullable": true
          },
          "annuaire_only": {
            "type": "boolean",
            "example": false,
            "default": false,
            "description": "When `true`, B2Brouter only registers the company in the PPF Annuaire\n(directory) and enables Peppol reception, without generating tax reports.\nFields `enterprise_size`, `naf_code` and `vat_regime` are not required in\nthis mode. When `false` (default), full e-Reporting is enabled and\n`enterprise_size`, `naf_code` and `vat_regime` become required.\n"
          },
          "vat_regime": {
            "type": "string",
            "example": "reel_normal_mensuel",
            "description": "French VAT declaration regime. Determines the frequency with which\ne-Reporting (flux 10) tax reports are transmitted to the DGFiP:\n- `reel_normal_mensuel` — transaction reports per décade (1–10, 11–20, 21–end of month)\n- `reel_normal_trimestriel` — monthly reports\n- `simplifie` — monthly reports. The regime is abolished on 2027-01-01;\n  from that date stored values are treated as `reel_normal_trimestriel`\n  and the value is no longer selectable.\n- `franchise_en_base` — bimonthly reports (Jan–Feb, Mar–Apr, …)\n\nRequired when activating full e-Reporting (`enabled: true` with\n`annuaire_only: false`); not required in annuaire-only mode.\n",
            "enum": [
              "reel_normal_mensuel",
              "reel_normal_trimestriel",
              "simplifie",
              "franchise_en_base",
              null
            ],
            "nullable": true
          },
          "oss_regime": {
            "type": "boolean",
            "example": false,
            "default": false,
            "description": "OSS (One-Stop-Shop) regime for cross-border B2C sales. When `true`, every\nbreakdown of a foreign-consumer simplified invoice is reported to flux 10\nas not subject to French VAT (TNT1, taux 0), covering destination-country\nrates that collide with French ones (e.g. AT 20%). When `false` (default),\nonly rates outside the authorized French list are transcoded.\n\nApplies to every cross-border B2C sale of the account: do not enable it if\ninvoices can mix destination-country VAT lines with French VAT lines, because\nthe French lines would also be reported as not subject to French VAT\n(under-declaration). Per-line VAT country is not supported yet.\n"
          },
          "report_received_only_when_accepted": {
            "type": "boolean",
            "example": false,
            "default": false,
            "description": "Controls when the tax report of a cross-border received invoice (flux 10 Bi2B\npurchase) is created. When `false` (default), it is created as soon as the invoice\nis received. When `true`, it is created only when the invoice is marked as\n`accepted`, so an invoice the client refuses is never declared. The explicit\n`POST /invoices/{id}/generate_tax_report` still creates the report whatever the\ninvoice state, so it stays available for an invoice that is never accepted.\n\nBear in mind a received invoice that is never accepted is never declared automatically.\nThe flux 10 period is keyed on the invoice date, not on the acceptance date, so accepting\nan invoice whose period was already transmitted leaves the report parked for a corrective\n(RE) transmission rather than declaring it.\n"
          },
          "peppol_email_fallback": {
            "type": "boolean",
            "example": false,
            "default": false,
            "description": "Whether to fall back to email when the recipient cannot be reached over Peppol. Applies to\nan invoice whose contact is set to the `peppol` transport and is registered in the DGFiP\nannuaire, but whose Peppol participant lookup comes back as a confirmed absence.\n\nWhen `false` (default), no reroute happens: the send is blocked before it leaves, with\n`The receiver is not registered in the Peppol network to receive invoices.`, so the sender\ndecides how to deliver the invoice. When `true`, the send is rerouted to email in Factur-X\nEN 16931 and the contact is left untouched; `to_net` then reports `email`.\n\nA transient SML or SMP outage is never a confirmed absence and never reroutes, whatever this\nflag says. The flux 1 declaration is unaffected either way — it travels its own SFTP circuit,\nindependent of the transport the invoice takes to the buyer.\n"
          },
          "peppol_migration_code": {
            "type": "string",
            "writeOnly": true,
            "example": "Xk9$mQ2!vTz4",
            "description": "Migration code issued by the provider that currently publishes the account's Peppol identifier, so the identifier moves to B2Brouter as part of this activation.\n\nSend it only when creating an enabled DGFiP setting for an account whose identifier B2Brouter does not publish yet — the case that otherwise fails with a `422` telling you the identifier is already published with another provider. On an update, or when no migration applies, the code is refused with a `422`, never ignored; in the sandbox it is refused with a `409`, since migration codes are unavailable there. It is write-only: it never appears in a response.\n"
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was updated",
            "readOnly": true
          }
        }
      },
      "LhdnTaxReportSetting": {
        "type": "object",
        "description": "Represents a tax report settings for 'lhdn' as an object",
        "properties": {
          "code": {
            "type": "string",
            "example": "lhdn",
            "description": "The Tax Report Authority code.",
            "enum": [
              "lhdn"
            ]
          },
          "start_date": {
            "type": "string",
            "format": "date-time",
            "example": "2024-07-09T00:00:00.000Z",
            "description": "Date when the Tax Report Setting was enabled. If not provided, the current date and time will be used..",
            "nullable": true
          },
          "auto_generate": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Generate the Tax Report automatically"
          },
          "auto_send": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Send the Tax Report automatically"
          },
          "enabled": {
            "type": "boolean",
            "example": true,
            "default": true,
            "description": "Represents if the tax report setting is enabled"
          },
          "msic": {
            "type": "string",
            "example": "01111",
            "description": "Malaysia Standard Industrial Classification (MSIC) Code",
            "enum": [
              "00000",
              "A",
              "01111",
              "01112",
              "01113",
              "01119",
              "01120",
              "01131",
              "01132",
              "01133",
              "01134",
              "01135",
              "01136",
              "01137",
              "01138",
              "01140",
              "01150",
              "01160",
              "01191",
              "01192",
              "01193",
              "01199",
              "01210",
              "01221",
              "01222",
              "01223",
              "01224",
              "01225",
              "01226",
              "01227",
              "01228",
              "01229",
              "01231",
              "01232",
              "01233",
              "01239",
              "01241",
              "01249",
              "01251",
              "01252",
              "01253",
              "01259",
              "01261",
              "01262",
              "01263",
              "01269",
              "01271",
              "01272",
              "01273",
              "01279",
              "01281",
              "01282",
              "01283",
              "01284",
              "01285",
              "01289",
              "01291",
              "01292",
              "01293",
              "01294",
              "01295",
              "01296",
              "01299",
              "01301",
              "01302",
              "01303",
              "01304",
              "01411",
              "01412"
            ]
          },
          "type_operation": {
            "type": "string",
            "example": "services",
            "description": "Default Type of Operation.",
            "enum": [
              "services",
              "goods"
            ]
          },
          "classification_code": {
            "type": "string",
            "description": "Default classification code, that defines the category of products or services being billed as a result of a commercial transaction.\n",
            "enum": [
              "001",
              "002",
              "003",
              "004",
              "005",
              "006",
              "007",
              "008",
              "009",
              "010",
              "011",
              "012",
              "013",
              "014",
              "015",
              "016",
              "017",
              "018",
              "019",
              "020",
              "021",
              "022",
              "023",
              "024",
              "025",
              "026",
              "027",
              "028",
              "029",
              "030",
              "031",
              "032",
              "033",
              "034",
              "035",
              "036",
              "037",
              "038",
              "039",
              "040",
              "041",
              "042",
              "043",
              "044",
              "045"
            ]
          },
          "locked": {
            "type": "boolean",
            "example": true,
            "description": "Cannot be completely modified or deleted",
            "readOnly": true
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was created",
            "readOnly": true
          },
          "updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2024-06-06T11:51:57Z",
            "description": "Date when the Tax Report Setting was updated",
            "readOnly": true
          }
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/UnauthorizedError"
            }
          }
        }
      },
      "NotFound": {
        "description": "Not Found",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "UnprocessableEntity": {
        "description": "Unprocessable Entity",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ForbiddenError"
            }
          }
        }
      }
    }
  }
}
````