Sign in

v2

latestOpenAPI 3.0.32026-08-05174296703.4 KB
offer

previewCustomizeOfferAndServices offer

Calculate offer with selected payment terms and services without mutating it

put/offers/{id}/preview-customize-terms-services

Path parameters

idstring regexp required

Offer ID

Example:739b63c2-9e58-4964-b38d-4ebb424de242

Offer ID

Query parameters

tokenstring

the shared token

Example:abc123

the shared token

Request body

Example request

{
  "lines": [
    {
      "offer_line_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
      "selected_contract_terms_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
      "selected_services": [
        "abc123"
      ]
    }
  ]
}

Response

OK response.

created_atstring date-time required
customer_has_vat_numberboolean required
emailstring email

User's email that was added on offer creation

exit_redirectstring

URL used to redirect if there is an error

expires_atstring date-time required
has_single_term_durationboolean required

Whether all rental line items must share a single term duration (derived from the contractual entity)

idstring regexp required

Offer ID

payment_method_requiredboolean required

Whether the checkout must collect a payment method (derived from the offer's contractual entity server-side)

redirect_to_superseding_offer_urlstring

link to the top-most superseding offer

sales_channel'telesales' | 'ecommerce' required
seller_offer_referencestring required

Partner's own reference for this offer

status'created' | 'voided' | 'accepted' | 'expired' | 'rejected' | 'pending_review' | 'declined' required

Example response

{
  "created_at": "1970-01-01T00:00:01Z",
  "customer_has_vat_number": false,
  "email": "alice@example.com",
  "exit_redirect": "abc123",
  "expires_at": "1970-01-01T00:00:01Z",
  "has_single_term_duration": false,
  "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
  "lines": [
    {
      "applied_discount_id": "abc123",
      "available_contract_terms": {
        "pay_now": {
          "amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          },
          "id": "739b63c2-9e58-4964-b38d-4ebb424de242"
        },
        "rent": {
          "duration": 6,
          "durations": [
            12
          ],
          "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
          "monthly_amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          }
        }
      },
      "available_first_party_services": [
        {
          "additional_values": {
            "accessory_type": "experiment_charger",
            "deductible_price": {
              "currency": "EUR",
              "gross": 119000,
              "net": 100000
            },
            "images": {
              "url1x": "abc123",
              "url2x": "abc123",
              "url3x": "abc123"
            }
          },
          "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
          "monthly_price": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          },
          "type": "topi_replace"
        }
      ],
      "base_rental_price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "contract_terms_list": [
        {
          "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
          "payload": {
            "amount": {
              "currency": "EUR",
              "gross": 119000,
              "net": 100000
            },
            "duration": 6
          },
          "type": "rent"
        }
      ],
      "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
      "pretty_id": "abc123",
      "price": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "pricing_category": "legacy_phone_24",
      "product_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
      "quantity": 1,
      "requires_serial_number": false,
      "selected_contract_terms_id": "abc123",
      "selected_first_party_service_ids": [
        "abc123"
      ],
      "seller_product_provided_by": "abc123",
      "seller_product_references": [
        {
          "reference": "123ab-5343",
          "source": "sap"
        }
      ],
      "seller_product_type": "software",
      "sublines": [
        {
          "applied_discount_id": "abc123",
          "available_contract_terms": {
            "pay_now": {
              "amount": {
                "currency": "EUR",
                "gross": 119000,
                "net": 100000
              },
              "id": "739b63c2-9e58-4964-b38d-4ebb424de242"
            },
            "rent": {
              "duration": 6,
              "durations": [
                12
              ],
              "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
              "monthly_amount": {
                "currency": "EUR",
                "gross": 119000,
                "net": 100000
              }
            }
          },
          "available_first_party_services": [
            {
              "additional_values": {
                "accessory_type": "experiment_charger",
                "deductible_price": {
                  "currency": "EUR",
                  "gross": 119000,
                  "net": 100000
                },
                "images": {
                  "url1x": "abc123",
                  "url2x": "abc123",
                  "url3x": "abc123"
                }
              },
              "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
              "monthly_price": {
                "currency": "EUR",
                "gross": 119000,
                "net": 100000
              },
              "type": "topi_replace"
            }
          ],
          "base_rental_price": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          },
          "contract_terms_list": [
            {
              "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
              "payload": {
                "amount": {
                  "currency": "EUR",
                  "gross": 119000,
                  "net": 100000
                },
                "duration": 6
              },
              "type": "rent"
            }
          ],
          "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
          "pretty_id": "abc123",
          "price": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          },
          "pricing_category": "legacy_phone_24",
          "product_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
          "quantity": 1,
          "requires_serial_number": false,
          "selected_contract_terms_id": "abc123",
          "selected_first_party_service_ids": [
            "abc123"
          ],
          "seller_product_provided_by": "abc123",
          "seller_product_references": [
            {
              "reference": "123ab-5343",
              "source": "sap"
            }
          ],
          "seller_product_type": "software",
          "subtitle": "abc123",
          "title": "abc123"
        }
      ],
      "subtitle": "abc123",
      "title": "abc123"
    }
  ],
  "payment_method_required": false,
  "pricing_overview": {
    "instead_of_amount": {
      "currency": "EUR",
      "gross": 119000,
      "net": 100000
    },
    "items_summaries": [
      {
        "identifier": "abc123",
        "pay_now": {
          "pay_now_amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          }
        },
        "pay_now_excluding_sublines": {
          "pay_now_amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          }
        },
        "rent": [
          {
            "duration": 12,
            "monthly_amount": {
              "currency": "EUR",
              "gross": 119000,
              "net": 100000
            }
          }
        ],
        "rent_excluding_sublines": [
          {
            "duration": 12,
            "monthly_amount": {
              "currency": "EUR",
              "gross": 119000,
              "net": 100000
            }
          }
        ],
        "total_pay_now": {
          "pay_now_amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          }
        },
        "total_rent": [
          {
            "duration": 12,
            "monthly_amount": {
              "currency": "EUR",
              "gross": 119000,
              "net": 100000
            }
          }
        ]
      }
    ],
    "rent_info": {
      "rent_only_amount": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "tenure_lines": [
        {
          "amount": {
            "currency": "EUR",
            "gross": 119000,
            "net": 100000
          },
          "duration": 6
        }
      ],
      "total_rent": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      }
    },
    "should_show_instead_of_amount": false,
    "total_amount_first_payment": {
      "currency": "EUR",
      "gross": 119000,
      "net": 100000
    },
    "total_amount_first_payment_without_shipping": {
      "currency": "EUR",
      "gross": 119000,
      "net": 100000
    },
    "total_purchase_amount": {
      "currency": "EUR",
      "gross": 119000,
      "net": 100000
    }
  },
  "redirect_to_superseding_offer_url": "abc123",
  "sales_channel": "ecommerce",
  "seller_info": {
    "address": {
      "city": "abc123",
      "country_code": "DE",
      "line1": "abc123",
      "line2": "aaa",
      "postal_code": "abc123",
      "region": "abc123"
    },
    "capability_add_custom_products": false,
    "capability_anonymized_pricing": false,
    "capability_anonymous_ecom_offer_creation": false,
    "capability_bundles": false,
    "capability_chatbot_id": "abc123",
    "capability_dual_pricing": false,
    "capability_hide_buy_now": false,
    "capability_international_shipment": false,
    "currency": "abc123",
    "email": "abc123",
    "id": "739b63c2-9e58-4964-b38d-4ebb424de242",
    "logo_url": "abc123",
    "name": "abc123",
    "parent_seller_id": "abc123",
    "pdf_reader_assistant_id": "abc123",
    "pretty_name": "abc123",
    "product_reference_source": "abc123"
  },
  "seller_offer_reference": "abc123",
  "shipping": {
    "is_in_store_pickup": false,
    "price": {
      "currency": "EUR",
      "gross": 119000,
      "net": 100000
    },
    "seller_shipping_reference": "Sandbox Shipping Service"
  },
  "status": "voided"
}