--- title: "Create an e-reporting business region" method: POST path: "/v1/e-reporting/business-regions" tags: ["E-Reporting"] --- # Create an e-reporting business region `POST /v1/e-reporting/business-regions` Creates an e-reporting business region. ## Headers - `Accept-Encoding` string - `Content-Encoding` string - `Authorization` string - `Zuora-Track-Id` string - `Zuora-Entity-Ids` string - `Zuora-Version` string - `Zuora-Org-Ids` string ## Request body - PostEReportingBusinessRegionRequest - `country` string, required — The two-digit ISO code of the country where you must comply with e-reporting requirements. For example, `ES` for Spain. This field is immutable after creation. - `reportingScheme` 'GENERIC_EREPORTING' | 'SII' | 'TICKETBAI', required — The reporting scheme that determines the e-reporting format and protocol. This field is immutable after creation. - `engineId` string, required — The unique ID of the e-reporting service provider (engine) to associate with this business region. - `businessName` string, required — The full official name that the Seller is registered with the relevant legal authority. - `state` string — The name of the state or province within the country where the business is located. - `city` string — The name of the city where the business is located. - `postalCode` string — The postal code of the Seller's business address. - `addressLine1` string — The first line of the Seller's business address. - `addressLine2` string — The second line of the Seller's business address. - `businessNumber` string — The unique identifier number of the legal entity or person that you do business with. - `businessNumberSchemeId` string — The identification scheme identifier that an official registrar issues to identify the Seller as a legal entity or person. - `tradeName` string — The name that the Seller is known as, other than the legal business name. - `endpointId` string — The Seller's electronic address to which application-level responses might be delivered. - `endpointSchemeId` string — The identification scheme identifier of the Seller's electronic address. - `taxRegisterNumber` string — The Seller's tax identification number or local identification for tax purposes. - `contactName` string — The name of the Seller contact to receive e-reporting data. - `phoneNumber` string — The business phone number of the Seller contact to receive e-reporting data. - `email` string, email — The email address of the Seller contact to receive e-reporting data. - `mode` 'INDIVIDUAL' | 'BATCH' — The processing mode for e-reporting submissions. Defaults to `INDIVIDUAL`. - `natureKey` string — An optional customer-provided identifier for the business region. - `invoiceEnabled` boolean — Whether invoice documents are enabled for e-reporting in this business region. Defaults to `false`. - `creditMemoEnabled` boolean — Whether credit memo documents are enabled for e-reporting in this business region. Defaults to `false`. - `debitMemoEnabled` boolean — Whether debit memo documents are enabled for e-reporting in this business region. Defaults to `false`. - `paymentEnabled` boolean — Whether payment documents are enabled for e-reporting in this business region. Defaults to `false`. - `refundEnabled` boolean — Whether refund documents are enabled for e-reporting in this business region. Defaults to `false`. - `creditMemoApplicationEnabled` boolean — Whether credit memo application events are enabled for e-reporting in this business region. Defaults to `false`. - `invoicePostedTriggerEnabled` boolean — Whether the invoice posted event triggers an e-reporting submission. Defaults to `false`. - `cmPostedTriggerEnabled` boolean — Whether the credit memo posted event triggers an e-reporting submission. Defaults to `false`. - `dmPostedTriggerEnabled` boolean — Whether the debit memo posted event triggers an e-reporting submission. Defaults to `false`. - `paymentAppliedTriggerEnabled` boolean — Whether the payment applied event triggers an e-reporting submission. Defaults to `false`. - `refundAppliedTriggerEnabled` boolean — Whether the refund applied event triggers an e-reporting submission. Defaults to `false`. - `creditMemoApplicationTriggerEnabled` boolean — Whether the credit memo application event triggers an e-reporting submission. Defaults to `false`. - `einvoiceSuccessTriggerEnabled` boolean — Whether a successful e-invoice submission triggers an e-reporting submission. Defaults to `false`. - `invoiceFilters` object[] — The filter conditions applied to invoice documents before e-reporting submission. Valid root object types: `Invoice`, `InvoiceItem`. - `creditMemoFilters` object[] — The filter conditions applied to credit memo documents before e-reporting submission. Valid root object types: `CreditMemo`, `CreditMemoItem`. - `debitMemoFilters` object[] — The filter conditions applied to debit memo documents before e-reporting submission. Valid root object types: `DebitMemo`, `DebitMemoItem`. - `paymentFilters` object[] — The filter conditions applied when a payment is applied before e-reporting submission. Valid root object type: `Payment`. Item sub-queries may use `PaymentApplication`. - `refundFilters` object[] — The filter conditions applied when a refund is applied before e-reporting submission. Valid root object type: `Refund`. Item sub-queries may use `RefundApplication`. - `creditMemoApplicationFilters` object[] — The filter conditions applied when a credit memo is applied before e-reporting submission. Valid root object type: `CreditMemoApplication`. Item sub-queries may use `CreditMemoApplicationItem`. - `b2bFileFormat` string — The file format used for business-to-business e-reporting submissions. - `b2cFileFormat` string — The file format used for business-to-consumer e-reporting submissions. - `b2gFileFormat` string — The file format used for business-to-government e-reporting submissions. - `responseMapping` object — A mapping of response field keys to their handling configuration for e-reporting responses. ## Response `200` OK - EReportingBusinessRegionsResponse - `processId` string — The ID of the process that handles the operation. - `reasons` object[] — The container of the error code and message. This field is available only if the `success` field is `false`. - `code` string — The error code of response. - `message` string — The detail information of the error response - `requestId` string, uuid — Unique identifier of the request. - `success` boolean — Indicates whether the call succeeded. - `regions` EReportingBusinessRegion[] — A list of e-reporting business regions. - `id` string — The unique ID of the e-reporting business region. - `country` string — The two-digit ISO code of the country where you must comply with e-reporting requirements. For example, `ES` for Spain. For the full list of country codes, see ISO Standard Country Codes. - `state` string — The name of the state or province within the country where the business is located. - `city` string — The name of the city where the business is located. - `postalCode` string — The postal code of the Seller's business address. - `addressLine1` string — The first line of the Seller's business address. - `addressLine2` string — The second line of the Seller's business address. - `businessName` string — The full official name that the Seller is registered with the relevant legal authority. - `businessNumber` string — The unique identifier number of the legal entity or person that you do business with. - `businessNumberSchemeId` string — The identification scheme identifier that an official registrar issues to identify the Seller as a legal entity or person. - `tradeName` string — The name that the Seller is known as, other than the legal business name. - `endpointId` string — The Seller's electronic address to which application-level responses might be delivered. - `endpointSchemeId` string — The identification scheme identifier of the Seller's electronic address. - `taxRegisterNumber` string — The Seller's tax identification number or local identification for tax purposes. - `contactName` string — The name of the Seller contact to receive e-reporting data. - `phoneNumber` string — The business phone number of the Seller contact to receive e-reporting data. - `email` string, email — The email address of the Seller contact to receive e-reporting data. - `engineId` string — The unique ID of the e-reporting service provider (engine) associated with this business region. - `reportingScheme` 'GENERIC_EREPORTING' | 'SII' | 'TICKETBAI' — The reporting scheme that determines the e-reporting format and protocol used for this business region. This field is immutable after creation. - `mode` 'INDIVIDUAL' | 'BATCH' — The processing mode for e-reporting submissions. - `natureKey` string — An optional customer-provided identifier for the business region. - `invoiceEnabled` boolean — Whether invoice documents are enabled for e-reporting in this business region. - `creditMemoEnabled` boolean — Whether credit memo documents are enabled for e-reporting in this business region. - `debitMemoEnabled` boolean — Whether debit memo documents are enabled for e-reporting in this business region. - `paymentEnabled` boolean — Whether payment documents are enabled for e-reporting in this business region. - `refundEnabled` boolean — Whether refund documents are enabled for e-reporting in this business region. - `creditMemoApplicationEnabled` boolean — Whether credit memo application events are enabled for e-reporting in this business region. - `invoicePostedTriggerEnabled` boolean — Whether the invoice posted event triggers an e-reporting submission. - `cmPostedTriggerEnabled` boolean — Whether the credit memo posted event triggers an e-reporting submission. - `dmPostedTriggerEnabled` boolean — Whether the debit memo posted event triggers an e-reporting submission. - `paymentAppliedTriggerEnabled` boolean — Whether the payment applied event triggers an e-reporting submission. - `refundAppliedTriggerEnabled` boolean — Whether the refund applied event triggers an e-reporting submission. - `creditMemoApplicationTriggerEnabled` boolean — Whether the credit memo application event triggers an e-reporting submission. - `einvoiceSuccessTriggerEnabled` boolean — Whether a successful e-invoice submission triggers an e-reporting submission. - `invoiceFilters` object[] — The filter conditions applied to invoice documents before e-reporting submission. Valid root object types: `Invoice`, `InvoiceItem`. - `creditMemoFilters` object[] — The filter conditions applied to credit memo documents before e-reporting submission. Valid root object types: `CreditMemo`, `CreditMemoItem`. - `debitMemoFilters` object[] — The filter conditions applied to debit memo documents before e-reporting submission. Valid root object types: `DebitMemo`, `DebitMemoItem`. - `paymentFilters` object[] — The filter conditions applied when a payment is applied before e-reporting submission. Valid root object type: `Payment`. Item sub-queries may use `PaymentApplication`. - `refundFilters` object[] — The filter conditions applied when a refund is applied before e-reporting submission. Valid root object type: `Refund`. Item sub-queries may use `RefundApplication`. - `creditMemoApplicationFilters` object[] — The filter conditions applied when a credit memo is applied before e-reporting submission. Valid root object type: `CreditMemoApplication`. Item sub-queries may use `CreditMemoApplicationItem`. - `b2bFileFormat` string — The file format used for business-to-business e-reporting submissions. - `b2cFileFormat` string — The file format used for business-to-consumer e-reporting submissions. - `b2gFileFormat` string — The file format used for business-to-government e-reporting submissions. - `responseMapping` object — A mapping of response field keys to their handling configuration for e-reporting responses. ## Other responses - `500` — Internal Server Error - `4XX` — Request Errors ## Changes - **2026-08-15** `702f3caf3985` — 1 info - endpoint added [Change history](https://skmtc.dev/zuora/apis/api-reference/changes/v1/e-reporting/business-regions/post.md) --- [API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)