Sign in

v2

latestOpenAPI 3.0.32026-08-05174296703.4 KB
ops

setOfferEndCustomerId offer

Set the end customer id for an existing offer

put/ops/offers/{id}/end_customer_id

Path parameters

idstring regexp required

Offer ID

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

Offer ID

Request body

end_customer_idstring required

The end_customer_id that should be attached to the offer

Example request

{
  "end_customer_id": "abc123"
}

Response

OK response.

created_atstring date-time required
declined_atstring date-time
exit_redirectstring

URL to redirect to on error

expires_atstring date-time required
idstring regexp required

Offer ID

offer_confirmed_atstring date-time
offer_linkstring
order_idstring regexp

Order ID

phone_numberstring

Phone number

redirect_to_superseding_offer_urlstring

link to the top-most offer in the superseding chain

rejection_reasonstring

Rejection reason, if the offer was rejected

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
success_redirectstring

URL to redirect to on success

superseded_by_idstring regexp

ID of the offer that superseded this one (when voided)

total_assetsinteger required

amount of assets in the offer: sum(lines.quantity)

total_linesinteger required

amount of line items in the offer

total_lines_leasableinteger

amount of rentable line items

total_lines_rentableinteger

amount of rentable line items

updated_atstring date-time
user_idstring regexp

User ID

Example response

{
  "agent": {
    "email": "alice@example.com",
    "external_agent_id": "abc123",
    "name": "abc123",
    "phone": "abc123"
  },
  "contract_values": {
    "pay_now": {
      "amount": {
        "currency": "EUR",
        "gross": 119000,
        "net": 100000
      },
      "total_assets": 1,
      "total_lines": 1
    },
    "rent": [
      {
        "duration": 6,
        "durations": [
          12
        ],
        "monthly_amount": {
          "currency": "EUR",
          "gross": 119000,
          "net": 100000
        },
        "total_assets": 1,
        "total_lines": 1
      }
    ]
  },
  "created_at": "1970-01-01T00:00:01Z",
  "customer": {
    "company": {
      "billing_address": {
        "city": "abc123",
        "country_code": "DE",
        "line1": "abc123",
        "line2": "aaa",
        "postal_code": "abc123",
        "region": "abc123"
      },
      "name": "abc123",
      "tax_number": "abc123",
      "type": "Partnership",
      "vat_number": "DE123456789"
    },
    "email": "alice@example.com",
    "end_customer_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
    "full_name": "abc123",
    "id": "739b63c2-9e58-4964-b38d-4ebb424de242"
  },
  "declined_at": "1970-01-01T00:00:01Z",
  "exit_redirect": "abc123",
  "expires_at": "1970-01-01T00:00:01Z",
  "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"
    }
  ],
  "offer_confirmed_at": "1970-01-01T00:00:01Z",
  "offer_link": "abc123",
  "order_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
  "phone_number": "abc123",
  "redirect_to_superseding_offer_url": "abc123",
  "rejection_reason": "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"
  },
  "shipping_address": {
    "city": "abc123",
    "country_code": "DE",
    "line1": "abc123",
    "line2": "aaa",
    "postal_code": "abc123",
    "recipient_name": "abc123",
    "region": "abc123"
  },
  "status": "voided",
  "success_redirect": "abc123",
  "superseded_by_id": "739b63c2-9e58-4964-b38d-4ebb424de242",
  "total_assets": 1,
  "total_lines": 1,
  "total_lines_leasable": 1,
  "total_lines_rentable": 1,
  "total_value": {
    "currency": "EUR",
    "gross": 119000,
    "net": 100000
  },
  "updated_at": "1970-01-01T00:00:01Z",
  "user_id": "739b63c2-9e58-4964-b38d-4ebb424de242"
}