From 9b8cb573f34c5fb30e64f64e67736f6efc7d13fa Mon Sep 17 00:00:00 2001 From: Mazaher Date: Wed, 5 Aug 2026 16:17:10 +0200 Subject: [PATCH 1/7] docs(OPS-39709): document PrepaidOrVcc billing automation prepayment Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/changelog/README.md | 10 ++++++++++ connector-api/operations/billingautomations.md | 11 ++++++----- 2 files changed, 16 insertions(+), 5 deletions(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index 66b3aa10..c5766243 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -1,6 +1,16 @@ # Changelog {% updates format="full" %} +{% update date="2026-08-05" %} + +## Billing automation prepayment condition for virtual credit cards + +- [Get all billing automations](../operations/billingautomations.md#get-all-billing-automations): +- [Add billing automations](../operations/billingautomations.md#add-billing-automations): +- [Update billing automations](../operations/billingautomations.md#update-billing-automations): + - Extended [Billing automation prepayment type](../operations/billingautomations.md#billing-automation-prepayment-type) enum with `PrepaidOrVcc` value. A billing automation with this prepayment condition applies to reservations that the OTA flagged as prepaid and to reservations with a virtual credit card attached. + +{% endupdate %} {% update date="2026-07-31" %} ## July 2026 updates diff --git a/connector-api/operations/billingautomations.md b/connector-api/operations/billingautomations.md index 4a8d9bf2..78e391d4 100644 --- a/connector-api/operations/billingautomations.md +++ b/connector-api/operations/billingautomations.md @@ -121,7 +121,7 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel | `Name` | string | required | Name of the billing automation. | | `Description` | string | optional | Description of the billing automation. | | `CompaniesWithRelations` | array of [Company with billing automation relation](billingautomations.md#company-with-billing-automation-relation) | required, max 1000 items | List of companies with relations to the billing automation. | -| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. | +| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. | | `AssignmentTargetType` | [Billing automation assignment target type](billingautomations.md#billing-automation-assignment-target-type) | required | Type of target company and customer assignment behavior. | | `TriggerType` | [Billing automation trigger type](billingautomations.md#billing-automation-trigger-type) | required | Trigger type of billing automation. | | `BillAggregationType` | [Billing automation bill aggregation type](billingautomations.md#billing-automation-bill-aggregation-type) | required | Type of bill aggregation. | @@ -149,8 +149,9 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel #### Billing automation prepayment type -* `All` - All -* `Prepaid` - Prepaid +* `All` - Applies regardless of prepayment. +* `Prepaid` - Applies only to reservations that the OTA flagged as prepaid. +* `PrepaidOrVcc` - Applies to reservations that the OTA flagged as prepaid and to reservations with a virtual credit card attached. #### Billing automation assignment target type @@ -283,7 +284,7 @@ Adds billing automations. | `Name` | string | required, max length 255 characters | Name of the billing automation. | | `Description` | string | optional, max length 1000 characters | Description of the billing automation. | | `CompaniesWithRelations` | array of [Company with billing automation relation](billingautomations.md#company-with-billing-automation-relation) | optional, max 1000 items | List of companies with relations indicating whether the company is considered a travel agency or a company in the reservation. Can only be empty if `AssignmentTargetType` is `CompanyAsDetails` or `NoCompany`. | -| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. | +| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. | | `AssignmentTargetType` | [Billing automation assignment target type](billingautomations.md#billing-automation-assignment-target-type) | required | Specifies the type of company assignment to the bill. If set to `NoCompany`, the `BillAggregationType` must be `AggregateByCustomer`. | | `TriggerType` | [Billing automation trigger type](billingautomations.md#billing-automation-trigger-type) | required | Trigger type of billing automation. | | `BillAggregationType` | [Billing automation bill aggregation type](billingautomations.md#billing-automation-bill-aggregation-type) | required | Specifies the type of bill aggregation. If the value is not `AggregateByCustomer`, the `AssignmentTargetType` must be `CompanyAsOwner`. | @@ -425,7 +426,7 @@ Updates one or more existing billing automations. | `Name` | [String update value](_objects.md#string-update-value) | optional, max length 255 characters | Name of the billing automation (or null should it not be updated). | | `Description` | [String update value](_objects.md#string-update-value) | optional, max length 1000 characters | Description of the billing automation (or null should it not be updated). | | `Companies` | [Company with billing automation relation array update value](billingautomations.md#company-with-billing-automation-relation-array-update-value) | optional, max length 1000 characters | List of companies with relations indicating whether the company should be considered as a travel agency or a company in the reservation. This list can only be empty if the `AssignmentTargetType` is `CompanyAsDetails` or `NoCompany`. Set to null if the value is not updated. | -| `Prepayment` | [Billing automation prepayment update value](_objects.md#string-update-value) | optional | Type of prepayment (or null should it not be updated). | +| `Prepayment` | [Billing automation prepayment update value](_objects.md#string-update-value) | optional | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. Set to null if the value is not updated. | | `AssignmentTargetType` | [Billing automation assignment target type update value](_objects.md#string-update-value) | optional | Specifies the type of company assignment to the bill. If set to `NoCompany`, the `BillAggregationType` must be `AggregateByCustomer`. Set to null if the value is not updated. | | `BillAggregationType` | [Billing automation bill aggregation type update value](_objects.md#string-update-value) | optional | Defines the aggregation target type for billing automation. If not `AggregateByCustomer`, the `AssignmentTargetType` must be `CompanyAsOwner`. Set to null if the value is not updated. | | `OrderItemConsumptionPeriod` | [Billing automation order item consumption period type update value](_objects.md#string-update-value) | optional | Specifies the order item consumption period type for the billing automation. Required if the `TriggerType` is recurring. Can be null if the value is not updated. | From 993bca106bec43cb2d67460d3c8d02fc7549da48 Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 10:51:58 +0200 Subject: [PATCH 2/7] docs(OPS-39709): note description clarifications in changelog entry Addresses PR #74 review: the entry covered the enum extension but not the description clarifications the same change makes. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/changelog/README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index c5766243..4a18152b 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -9,6 +9,7 @@ - [Add billing automations](../operations/billingautomations.md#add-billing-automations): - [Update billing automations](../operations/billingautomations.md#update-billing-automations): - Extended [Billing automation prepayment type](../operations/billingautomations.md#billing-automation-prepayment-type) enum with `PrepaidOrVcc` value. A billing automation with this prepayment condition applies to reservations that the OTA flagged as prepaid and to reservations with a virtual credit card attached. + - Clarified the `Prepayment` property description and the `All` and `Prepaid` value descriptions to state which reservations each value applies to. Documentation-only, no change to API. {% endupdate %} {% update date="2026-07-31" %} From ed587792ea9a74256bfbdf5b54b51a62f3dbcaa6 Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 10:55:19 +0200 Subject: [PATCH 3/7] docs(OPS-39709): set changelog date to mews#86733 release date Addresses PR #74 review: the entry must not publish PrepaidOrVcc as an accepted request value before the contract change ships. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/changelog/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index 4a18152b..d21c7e75 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -1,7 +1,7 @@ # Changelog {% updates format="full" %} -{% update date="2026-08-05" %} +{% update date="2026-08-11" %} ## Billing automation prepayment condition for virtual credit cards From 2ab781ebecacd193bc7dad5a90d373e3ce1a48c8 Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 11:33:37 +0200 Subject: [PATCH 4/7] docs(OPS-39709): align enum bullets with mews#86733 Description attributes The enum descriptions were added upstream, so the hand-written bullets now mirror the spec verbatim and regeneration after the release is a no-op instead of a reworded diff. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/operations/billingautomations.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/connector-api/operations/billingautomations.md b/connector-api/operations/billingautomations.md index 78e391d4..ed1e55e2 100644 --- a/connector-api/operations/billingautomations.md +++ b/connector-api/operations/billingautomations.md @@ -149,9 +149,9 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel #### Billing automation prepayment type -* `All` - Applies regardless of prepayment. -* `Prepaid` - Applies only to reservations that the OTA flagged as prepaid. -* `PrepaidOrVcc` - Applies to reservations that the OTA flagged as prepaid and to reservations with a virtual credit card attached. +* `All` - Applies to reservations regardless of prepayment. +* `Prepaid` - Applies only to reservations the OTA flagged as prepaid. +* `PrepaidOrVcc` - Applies to reservations the OTA flagged as prepaid, and to reservations with a virtual credit card attached. #### Billing automation assignment target type From cb796c418ad147c84d57ad2a3f7576e1117bd26d Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 11:43:56 +0200 Subject: [PATCH 5/7] docs(OPS-39709): drop property description changes removed from mews#86733 The three [SwaggerSchema] changes on BillingAutomation, BillingAutomationAddParameters and BillingAutomationUpdateParameters were taken out of the contract PR, so the rows documenting them described text the spec will never contain. Only the enum block remains, which matches the [Description] attributes verbatim. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/changelog/README.md | 2 +- connector-api/operations/billingautomations.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/connector-api/changelog/README.md b/connector-api/changelog/README.md index d21c7e75..549586ff 100644 --- a/connector-api/changelog/README.md +++ b/connector-api/changelog/README.md @@ -9,7 +9,7 @@ - [Add billing automations](../operations/billingautomations.md#add-billing-automations): - [Update billing automations](../operations/billingautomations.md#update-billing-automations): - Extended [Billing automation prepayment type](../operations/billingautomations.md#billing-automation-prepayment-type) enum with `PrepaidOrVcc` value. A billing automation with this prepayment condition applies to reservations that the OTA flagged as prepaid and to reservations with a virtual credit card attached. - - Clarified the `Prepayment` property description and the `All` and `Prepaid` value descriptions to state which reservations each value applies to. Documentation-only, no change to API. + - Clarified the `All` and `Prepaid` value descriptions to state which reservations each value applies to. Documentation-only, no change to API. {% endupdate %} {% update date="2026-07-31" %} diff --git a/connector-api/operations/billingautomations.md b/connector-api/operations/billingautomations.md index ed1e55e2..2c613361 100644 --- a/connector-api/operations/billingautomations.md +++ b/connector-api/operations/billingautomations.md @@ -121,7 +121,7 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel | `Name` | string | required | Name of the billing automation. | | `Description` | string | optional | Description of the billing automation. | | `CompaniesWithRelations` | array of [Company with billing automation relation](billingautomations.md#company-with-billing-automation-relation) | required, max 1000 items | List of companies with relations to the billing automation. | -| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. | +| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. | | `AssignmentTargetType` | [Billing automation assignment target type](billingautomations.md#billing-automation-assignment-target-type) | required | Type of target company and customer assignment behavior. | | `TriggerType` | [Billing automation trigger type](billingautomations.md#billing-automation-trigger-type) | required | Trigger type of billing automation. | | `BillAggregationType` | [Billing automation bill aggregation type](billingautomations.md#billing-automation-bill-aggregation-type) | required | Type of bill aggregation. | @@ -284,7 +284,7 @@ Adds billing automations. | `Name` | string | required, max length 255 characters | Name of the billing automation. | | `Description` | string | optional, max length 1000 characters | Description of the billing automation. | | `CompaniesWithRelations` | array of [Company with billing automation relation](billingautomations.md#company-with-billing-automation-relation) | optional, max 1000 items | List of companies with relations indicating whether the company is considered a travel agency or a company in the reservation. Can only be empty if `AssignmentTargetType` is `CompanyAsDetails` or `NoCompany`. | -| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. | +| `Prepayment` | [Billing automation prepayment type](billingautomations.md#billing-automation-prepayment-type) | required | Type of prepayment. | | `AssignmentTargetType` | [Billing automation assignment target type](billingautomations.md#billing-automation-assignment-target-type) | required | Specifies the type of company assignment to the bill. If set to `NoCompany`, the `BillAggregationType` must be `AggregateByCustomer`. | | `TriggerType` | [Billing automation trigger type](billingautomations.md#billing-automation-trigger-type) | required | Trigger type of billing automation. | | `BillAggregationType` | [Billing automation bill aggregation type](billingautomations.md#billing-automation-bill-aggregation-type) | required | Specifies the type of bill aggregation. If the value is not `AggregateByCustomer`, the `AssignmentTargetType` must be `CompanyAsOwner`. | @@ -426,7 +426,7 @@ Updates one or more existing billing automations. | `Name` | [String update value](_objects.md#string-update-value) | optional, max length 255 characters | Name of the billing automation (or null should it not be updated). | | `Description` | [String update value](_objects.md#string-update-value) | optional, max length 1000 characters | Description of the billing automation (or null should it not be updated). | | `Companies` | [Company with billing automation relation array update value](billingautomations.md#company-with-billing-automation-relation-array-update-value) | optional, max length 1000 characters | List of companies with relations indicating whether the company should be considered as a travel agency or a company in the reservation. This list can only be empty if the `AssignmentTargetType` is `CompanyAsDetails` or `NoCompany`. Set to null if the value is not updated. | -| `Prepayment` | [Billing automation prepayment update value](_objects.md#string-update-value) | optional | Type of prepayment. `All` applies regardless of prepayment, `Prepaid` only to reservations the OTA flagged as prepaid, and `PrepaidOrVcc` also to reservations with a virtual credit card attached. Set to null if the value is not updated. | +| `Prepayment` | [Billing automation prepayment update value](_objects.md#string-update-value) | optional | Type of prepayment (or null should it not be updated). | | `AssignmentTargetType` | [Billing automation assignment target type update value](_objects.md#string-update-value) | optional | Specifies the type of company assignment to the bill. If set to `NoCompany`, the `BillAggregationType` must be `AggregateByCustomer`. Set to null if the value is not updated. | | `BillAggregationType` | [Billing automation bill aggregation type update value](_objects.md#string-update-value) | optional | Defines the aggregation target type for billing automation. If not `AggregateByCustomer`, the `AssignmentTargetType` must be `CompanyAsOwner`. Set to null if the value is not updated. | | `OrderItemConsumptionPeriod` | [Billing automation order item consumption period type update value](_objects.md#string-update-value) | optional | Specifies the order item consumption period type for the billing automation. Required if the `TriggerType` is recurring. Can be null if the value is not updated. | From 1f864c2287613d83a9c4e66f2e01cbb7e8a1aa4b Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 11:44:21 +0200 Subject: [PATCH 6/7] docs(OPS-39709): drop generated page edits, keep changelog only billingautomations.md is generated from the production swagger, so the enum block lands on its own in the regeneration that follows the mews#86733 release. Hand-editing it here only risked drift. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/operations/billingautomations.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/connector-api/operations/billingautomations.md b/connector-api/operations/billingautomations.md index 2c613361..4a8d9bf2 100644 --- a/connector-api/operations/billingautomations.md +++ b/connector-api/operations/billingautomations.md @@ -149,9 +149,8 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel #### Billing automation prepayment type -* `All` - Applies to reservations regardless of prepayment. -* `Prepaid` - Applies only to reservations the OTA flagged as prepaid. -* `PrepaidOrVcc` - Applies to reservations the OTA flagged as prepaid, and to reservations with a virtual credit card attached. +* `All` - All +* `Prepaid` - Prepaid #### Billing automation assignment target type From dd4b1ad12439cf30ddb81649deba6968c67890ae Mon Sep 17 00:00:00 2001 From: Mazaher Date: Thu, 6 Aug 2026 12:58:58 +0200 Subject: [PATCH 7/7] docs(OPS-39709): add regenerated reference page for PrepaidOrVcc Regeneration is manual, so a changelog-only PR would merge announcing the value while the reference page still showed the old enum. Output of _generator run against the mews#86733 build; to be re-verified against production after the release before merge. Co-Authored-By: Claude Opus 5 (1M context) --- connector-api/operations/billingautomations.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/connector-api/operations/billingautomations.md b/connector-api/operations/billingautomations.md index 4a8d9bf2..2c613361 100644 --- a/connector-api/operations/billingautomations.md +++ b/connector-api/operations/billingautomations.md @@ -149,8 +149,9 @@ Returns all billing automations. Note this operation uses [Pagination](../guidel #### Billing automation prepayment type -* `All` - All -* `Prepaid` - Prepaid +* `All` - Applies to reservations regardless of prepayment. +* `Prepaid` - Applies only to reservations the OTA flagged as prepaid. +* `PrepaidOrVcc` - Applies to reservations the OTA flagged as prepaid, and to reservations with a virtual credit card attached. #### Billing automation assignment target type