# Create Subscription

Create new subscription and send invitation.

Endpoint: POST /api/v1/partner/subscription
Version: 1.0

## Request fields (application/json):

  - `commercialName` (string)
    Commercial name of the subscription.
    Example: "Clave Informática S.L."

  - `cif` (string)
    Cif of the subscription.
    Example: "B12345678"

  - `name` (string, required)
    Name of the subscription.
    Example: "Clavei"

  - `discount` (number, required)
    Discount percentage.
    Example: 10

  - `web` (string)
    Web URL.
    Example: "https://www.acme.es"

  - `logo` (string)
    Picture or logo (URL or base64).
    Example: "https://www.acme.es/logo.png"

  - `contactPerson` (string)
    Main contact person.
    Example: "Juan Pérez"

  - `firstPhoneNumber` (string)
    First phone number.
    Example: "+34600111222"

  - `secondPhoneNumber` (string)
    Second phone number.
    Example: "+34600333444"

  - `email` (string)
    Subscription email address.
    Example: "info@acme.es"

  - `country` (integer)
    Country identifier.
    Example: 1

  - `state` (integer)
    State identifier.
    Example: 1

  - `address` (string)
    Postal address of the customer.
    Example: "Av. de la Estación, 5"

  - `postalCode` (string)
    Postal code.
    Example: "03001"

  - `city` (string)
    Subscription city.
    Example: "Alicante"

  - `externalCode` (string)
    Internal client code.
    Example: "Code customer"

  - `newsletter` (boolean)
    Indicate if you subscribe to the newsletter.
    Example: true

  - `plan` (integer)
    Plan identifier.
    Example: 1

  - `period` (integer)
    Period identifier.
    Example: 1

## Response 200 fields (application/json):

  - `id` (integer, required)
    Unique identifier of the entity
    Example: 1

  - `createdOn` (string)
    Subscription creation date.
    Example: "2025-10-01T12:05:36.930615+02:00"

  - `modifiedOn` (string)
    Subscription modification date.
    Example: "2025-10-01T12:05:36.930615+02:00"

  - `partner` (object)
    Subscription partner.

  - `partner.commercialName` (string)
    Commercial name of the partner.
    Example: "Clave Informática S.L."

  - `partner.cif` (string)
    Cif of the partner.
    Example: "B12345678"

  - `partner.name` (string)
    Name of the partner.
    Example: "Clavei"

  - `partner.email` (string)
    Partner email address.
    Example: "info@acme.es"

  - `partner.marginOne` (number)
    Product percentage margin.
    Example: 10

  - `partner.marginTwo` (number)
    Service percentage margin.
    Example: 10

  - `partner.logo` (string)
    Picture or logo (URL or base64).
    Example: "https://www.acme.es/logo.png"

  - `partner.status` (string)
    Partner status.
    Enum: "ACTIVE", "INACTIVE", "PENDING"

  - `partner.externalCode` (string)
    Internal client code.
    Example: "Code customer"

  - `partner.subscriptionLimit` (integer)
    Monthly subscription limit.
    Example: 100

  - `company` (object)
    Subscription company.

  - `company.companyName` (string)
    Company name.
    Example: "Clavei"

  - `company.companyType` (string)
    Type company.
    Enum: "SELF_EMPLOYED", "COMPANY", "CONSULTANT_COMPANY"

  - `company.companyStatus` (string)
    Status company.
    Enum: "ACTIVE", "INACTIVE", "LOCKED", "DELETED"

  - `company.employees` (string)
    Range of number of company employees.
    Enum: "ONE", "FIVE", "TEN", "TWENTY_FIVE", "FIFTY", "BIGGER"

  - `company.fullName` (string)
    Full company name.
    Example: "Clave Informática S.L."

  - `company.active` (boolean)
    Indicate if the company is active.
    Example: true

  - `company.country` (object)
    Country information.

  - `company.country.code` (string)
    Code country.
    Example: "ES"

  - `company.country.description` (string)
    Country name or description.
    Example: "Spain"

  - `company.country.isoCode` (string)
    ISO Alpha-2 country code.
    Example: "ES"

  - `company.phone` (string)
    Phone number.
    Example: "+34600111222"

  - `commercialName` (string)
    Commercial name of the subscription.
    Example: "Clave Informática S.L."

  - `cif` (string)
    Cif of the subscription.
    Example: "B12345678"

  - `name` (string)
    Name of the subscription.
    Example: "Clavei"

  - `discount` (number)
    Discount percentage.
    Example: 10

  - `web` (string)
    Web URL.
    Example: "https://www.acme.es"

  - `contactPerson` (string)
    Main contact person.
    Example: "Juan Pérez"

  - `firstPhoneNumber` (string)
    First phone number.
    Example: "+34600111222"

  - `secondPhoneNumber` (string)
    Second phone number.
    Example: "+34600333444"

  - `email` (string)
    Subscription email address.
    Example: "info@acme.es"

  - `state` (object)
    State information.

  - `state.code` (string, required)
    Code state.
    Example: "ES"

  - `state.description` (string)
    Description state.
    Example: "Spain"

  - `state.isoCode` (string)
    Iso code state.
    Example: "012"

  - `address` (string)
    Postal address of the customer.
    Example: "Av. de la Estación, 5"

  - `postalCode` (string)
    Postal code.
    Example: "03001"

  - `city` (string)
    Subscription city.
    Example: "Alicante"

  - `active` (boolean)
    True if the subscription is active.
    Example: true

  - `invitationCode` (string)
    Invitation code registration subscription.

  - `invitationSentOn` (string)
    Invitation sending date.
    Example: "2025-10-01T12:05:36.930615+02:00"

  - `invitationAcceptedOn` (string)
    Accepted invitation date.
    Example: "2025-10-01T12:05:36.930615+02:00"

  - `plan` (object)
    Assigned/contracted plan.

  - `plan.description` (string)
    Plan description.
    Example: "PLAN Integral"

  - `plan.suggested` (boolean)
    Suggested plan.
    Example: true

  - `period` (object)
    Assigned/contracted billing plan period.

  - `period.description` (string)
    Description period.
    Example: "Anual"

  - `period.months` (integer)
    Months period
    Example: 12

  - `status` (string)
    Subscription status.
    Enum: "ACTIVE", "INACTIVE", "PENDING"

  - `newsletter` (boolean)
    Indicate if you subscribe to the newsletter.
    Example: true

  - `lastAccess` (string)
    Last access to company.
    Example: "2025-10-01T12:05:36.930615+02:00"