Create contract

curl --request POST \
  --url https://api.useaira.com/v1/contracts/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "startDate": "2023-12-25",
  "endDate": "2023-12-25",
  "retroactiveDate": "2023-12-25",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "includeNewSubsidiariesOnUsageScope": true,
  "usageScopes": [
    {
      "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "allocations": [
    {
      "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "allocationPercentage": "<string>"
    }
  ],
  "billingSchedule": {
    "anchorDay": 16,
    "anchorMonth": 6.5
  },
  "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "autoIssue": true,
  "billingSettings": {
    "invoiceMinimumAmount": 1,
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "paymentGatewaySettings": {
    "dueDateMode": "days_after_issue",
    "dueOffsetDays": 1,
    "dueDay": 16,
    "dueMonthOffset": 0,
    "rollDueDateToBusinessDay": true
  },
  "planIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.useaira.com/v1/contracts/"

payload = {
    "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "retroactiveDate": "2023-12-25",
    "customFields": {
        "customField1": "value1",
        "customField2": ["value2", "value3"]
    },
    "includeNewSubsidiariesOnUsageScope": True,
    "usageScopes": [{ "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "allocations": [
        {
            "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "allocationPercentage": "<string>"
        }
    ],
    "billingSchedule": {
        "anchorDay": 16,
        "anchorMonth": 6.5
    },
    "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "autoIssue": True,
    "billingSettings": {
        "invoiceMinimumAmount": 1,
        "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "paymentGatewaySettings": {
        "dueDateMode": "days_after_issue",
        "dueOffsetDays": 1,
        "dueDay": 16,
        "dueMonthOffset": 0,
        "rollDueDateToBusinessDay": True
    },
    "planIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    startDate: '2023-12-25',
    endDate: '2023-12-25',
    retroactiveDate: '2023-12-25',
    customFields: {customField1: 'value1', customField2: ['value2', 'value3']},
    includeNewSubsidiariesOnUsageScope: true,
    usageScopes: [{customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    allocations: [
      {
        paymentAccountId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        allocationPercentage: '<string>'
      }
    ],
    billingSchedule: {anchorDay: 16, anchorMonth: 6.5},
    legalEntityId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taxRegimeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    autoIssue: true,
    billingSettings: {invoiceMinimumAmount: 1, productId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
    paymentGatewaySettings: {
      dueDateMode: 'days_after_issue',
      dueOffsetDays: 1,
      dueDay: 16,
      dueMonthOffset: 0,
      rollDueDateToBusinessDay: true
    },
    planIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.useaira.com/v1/contracts/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.useaira.com/v1/contracts/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'startDate' => '2023-12-25',
    'endDate' => '2023-12-25',
    'retroactiveDate' => '2023-12-25',
    'customFields' => [
        'customField1' => 'value1',
        'customField2' => [
                'value2',
                'value3'
        ]
    ],
    'includeNewSubsidiariesOnUsageScope' => true,
    'usageScopes' => [
        [
                'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ],
    'allocations' => [
        [
                'paymentAccountId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'allocationPercentage' => '<string>'
        ]
    ],
    'billingSchedule' => [
        'anchorDay' => 16,
        'anchorMonth' => 6.5
    ],
    'legalEntityId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taxRegimeId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'autoIssue' => true,
    'billingSettings' => [
        'invoiceMinimumAmount' => 1,
        'productId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'paymentGatewaySettings' => [
        'dueDateMode' => 'days_after_issue',
        'dueOffsetDays' => 1,
        'dueDay' => 16,
        'dueMonthOffset' => 0,
        'rollDueDateToBusinessDay' => true
    ],
    'planIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.useaira.com/v1/contracts/"

	payload := strings.NewReader("{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.useaira.com/v1/contracts/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.useaira.com/v1/contracts/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contractNumber": "<string>",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "startDate": "2023-12-25",
  "endDate": "2023-12-25",
  "retroactiveDate": "2023-12-25",
  "status": "active",
  "rateAdjustmentIndex": "none",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "invoiceAllocationStrategy": "single",
  "includeNewSubsidiariesOnUsageScope": true,
  "usageScopes": [
    {
      "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "allocations": [
    {
      "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "allocationPercentage": "<string>"
    }
  ],
  "billingSchedule": {
    "periodUnit": "week",
    "anchorSource": "based_on_contract_start_date",
    "anchorDay": 16,
    "anchorMonth": 6.5
  },
  "planInstances": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "status": "active"
    }
  ],
  "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "legalEntity": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "businessName": "<string>",
    "tradeName": "<string>"
  },
  "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "autoIssue": true,
  "billingSettings": {
    "invoiceMinimumAmount": 1,
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "paymentGatewaySettings": {
    "paymentMethod": "bolepix",
    "dueDateMode": "days_after_issue",
    "dueOffsetDays": 1,
    "dueDay": 16,
    "dueMonthOffset": 0,
    "rollDueDateToBusinessDay": true
  }
}

{
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "causations": [
    {
      "message": "<string>",
      "code": "<string>",
      "details": {}
    }
  ]
}

{
  "message": "<string>"
}

POST

contracts

Create contract

curl --request POST \
  --url https://api.useaira.com/v1/contracts/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '
{
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "startDate": "2023-12-25",
  "endDate": "2023-12-25",
  "retroactiveDate": "2023-12-25",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "includeNewSubsidiariesOnUsageScope": true,
  "usageScopes": [
    {
      "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "allocations": [
    {
      "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "allocationPercentage": "<string>"
    }
  ],
  "billingSchedule": {
    "anchorDay": 16,
    "anchorMonth": 6.5
  },
  "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "autoIssue": true,
  "billingSettings": {
    "invoiceMinimumAmount": 1,
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "paymentGatewaySettings": {
    "dueDateMode": "days_after_issue",
    "dueOffsetDays": 1,
    "dueDay": 16,
    "dueMonthOffset": 0,
    "rollDueDateToBusinessDay": true
  },
  "planIds": [
    "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  ]
}
'

import requests

url = "https://api.useaira.com/v1/contracts/"

payload = {
    "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "retroactiveDate": "2023-12-25",
    "customFields": {
        "customField1": "value1",
        "customField2": ["value2", "value3"]
    },
    "includeNewSubsidiariesOnUsageScope": True,
    "usageScopes": [{ "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }],
    "allocations": [
        {
            "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
            "allocationPercentage": "<string>"
        }
    ],
    "billingSchedule": {
        "anchorDay": 16,
        "anchorMonth": 6.5
    },
    "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "autoIssue": True,
    "billingSettings": {
        "invoiceMinimumAmount": 1,
        "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    },
    "paymentGatewaySettings": {
        "dueDateMode": "days_after_issue",
        "dueOffsetDays": 1,
        "dueDay": 16,
        "dueMonthOffset": 0,
        "rollDueDateToBusinessDay": True
    },
    "planIds": ["3c90c3cc-0d44-4b50-8888-8dd25736052a"]
}
headers = {
    "X-API-KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-KEY': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    startDate: '2023-12-25',
    endDate: '2023-12-25',
    retroactiveDate: '2023-12-25',
    customFields: {customField1: 'value1', customField2: ['value2', 'value3']},
    includeNewSubsidiariesOnUsageScope: true,
    usageScopes: [{customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'}],
    allocations: [
      {
        paymentAccountId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
        allocationPercentage: '<string>'
      }
    ],
    billingSchedule: {anchorDay: 16, anchorMonth: 6.5},
    legalEntityId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    taxRegimeId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    autoIssue: true,
    billingSettings: {invoiceMinimumAmount: 1, productId: '3c90c3cc-0d44-4b50-8888-8dd25736052a'},
    paymentGatewaySettings: {
      dueDateMode: 'days_after_issue',
      dueOffsetDays: 1,
      dueDay: 16,
      dueMonthOffset: 0,
      rollDueDateToBusinessDay: true
    },
    planIds: ['3c90c3cc-0d44-4b50-8888-8dd25736052a']
  })
};

fetch('https://api.useaira.com/v1/contracts/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.useaira.com/v1/contracts/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'startDate' => '2023-12-25',
    'endDate' => '2023-12-25',
    'retroactiveDate' => '2023-12-25',
    'customFields' => [
        'customField1' => 'value1',
        'customField2' => [
                'value2',
                'value3'
        ]
    ],
    'includeNewSubsidiariesOnUsageScope' => true,
    'usageScopes' => [
        [
                'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
        ]
    ],
    'allocations' => [
        [
                'paymentAccountId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
                'allocationPercentage' => '<string>'
        ]
    ],
    'billingSchedule' => [
        'anchorDay' => 16,
        'anchorMonth' => 6.5
    ],
    'legalEntityId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'taxRegimeId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'autoIssue' => true,
    'billingSettings' => [
        'invoiceMinimumAmount' => 1,
        'productId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ],
    'paymentGatewaySettings' => [
        'dueDateMode' => 'days_after_issue',
        'dueOffsetDays' => 1,
        'dueDay' => 16,
        'dueMonthOffset' => 0,
        'rollDueDateToBusinessDay' => true
    ],
    'planIds' => [
        '3c90c3cc-0d44-4b50-8888-8dd25736052a'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.useaira.com/v1/contracts/"

	payload := strings.NewReader("{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-KEY", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.useaira.com/v1/contracts/")
  .header("X-API-KEY", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.useaira.com/v1/contracts/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-KEY"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"startDate\": \"2023-12-25\",\n  \"endDate\": \"2023-12-25\",\n  \"retroactiveDate\": \"2023-12-25\",\n  \"customFields\": {\n    \"customField1\": \"value1\",\n    \"customField2\": [\n      \"value2\",\n      \"value3\"\n    ]\n  },\n  \"includeNewSubsidiariesOnUsageScope\": true,\n  \"usageScopes\": [\n    {\n      \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n    }\n  ],\n  \"allocations\": [\n    {\n      \"paymentAccountId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n      \"allocationPercentage\": \"<string>\"\n    }\n  ],\n  \"billingSchedule\": {\n    \"anchorDay\": 16,\n    \"anchorMonth\": 6.5\n  },\n  \"legalEntityId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"taxRegimeId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"autoIssue\": true,\n  \"billingSettings\": {\n    \"invoiceMinimumAmount\": 1,\n    \"productId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  },\n  \"paymentGatewaySettings\": {\n    \"dueDateMode\": \"days_after_issue\",\n    \"dueOffsetDays\": 1,\n    \"dueDay\": 16,\n    \"dueMonthOffset\": 0,\n    \"rollDueDateToBusinessDay\": true\n  },\n  \"planIds\": [\n    \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "contractNumber": "<string>",
  "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "startDate": "2023-12-25",
  "endDate": "2023-12-25",
  "retroactiveDate": "2023-12-25",
  "status": "active",
  "rateAdjustmentIndex": "none",
  "customFields": {
    "customField1": "value1",
    "customField2": [
      "value2",
      "value3"
    ]
  },
  "invoiceAllocationStrategy": "single",
  "includeNewSubsidiariesOnUsageScope": true,
  "usageScopes": [
    {
      "customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    }
  ],
  "allocations": [
    {
      "paymentAccountId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "allocationPercentage": "<string>"
    }
  ],
  "billingSchedule": {
    "periodUnit": "week",
    "anchorSource": "based_on_contract_start_date",
    "anchorDay": 16,
    "anchorMonth": 6.5
  },
  "planInstances": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "planId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "status": "active"
    }
  ],
  "legalEntityId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "legalEntity": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "businessName": "<string>",
    "tradeName": "<string>"
  },
  "taxRegimeId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "autoIssue": true,
  "billingSettings": {
    "invoiceMinimumAmount": 1,
    "productId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "paymentGatewaySettings": {
    "paymentMethod": "bolepix",
    "dueDateMode": "days_after_issue",
    "dueOffsetDays": 1,
    "dueDay": 16,
    "dueMonthOffset": 0,
    "rollDueDateToBusinessDay": true
  }
}

{
  "message": "<string>",
  "code": "<string>",
  "details": {},
  "causations": [
    {
      "message": "<string>",
      "code": "<string>",
      "details": {}
    }
  ]
}

{
  "message": "<string>"
}

Authorizations

X-API-KEY

string

header

required

API Key Authentication.

Body

application/json

Schema defining a contract.

customerId

string<uuid>

required

ID of the customer associated with this contract.

startDate

string<date>

required

Date when the contract becomes active.

endDate

string<date> | null

required

Optional date when the contract expires. If null, the contract has no end date.

retroactiveDate

string<date> | null

required

Optional retroactive date to apply contract changes from a past date.

rateAdjustmentIndex

null | enum<string>

required

Reference index (e.g. IPCA) used to filter contracts when applying a mass adjustment on contracts.

Available options:

none,

igpm,

ipca,

other,

null

customFields

object

required

Custom fields that can be associated with the entity. The fields must be previously created in the system before they can be used.

Show child attributes

Example:

{
  "customField1": "value1",
  "customField2": ["value2", "value3"]
}

invoiceAllocationStrategy

enum<string>

required

Invoice allocation strategy configured for the contract.

Available options:

single,

percent_split,

subsidiary_usage_split

includeNewSubsidiariesOnUsageScope

boolean

required

Whether future subsidiaries are automatically included in usage scope.

usageScopes

object[]

required

Customers that compose the usage scope for this contract.

Minimum array length: 1

Show child attributes

allocations

object[]

required

Payment account allocation configuration.

Minimum array length: 1

Show child attributes

billingSchedule

object

required

Schema defining billing schedule for a contract.

Show child attributes

legalEntityId

string<uuid> | null

ID of the legal entity associated with this contract. Optional on create; defaults to the tenant's default legal entity when absent.

taxRegimeId

string<uuid> | null

ID of the tax regime applied to invoices generated from this contract. Null when no regime is attached.

autoIssue

boolean

When true, invoices produced at billing-cycle close are issued automatically instead of waiting in review. Defaults to false when omitted; omitting it on update leaves the current value unchanged.

billingSettings

object | null

Schema defining billing settings for a contract.

Show child attributes

paymentGatewaySettings

object | null

Schema defining payment gateway settings for a contract.

Show child attributes

planIds

string<uuid>[]

Plans to instantiate on the new contract, each from its current active version and following the contract dates. The contract and its plan instances are created together: when any plan cannot be instantiated, nothing is created.

Response

Schema defining a contract.

string<uuid>

required

Unique identifier for the contract.

contractNumber

string

required

Human-readable contract identifier, sequential per customer (e.g. ACMEX-CTR-01). Generated by the server on creation.

customerId

string<uuid>

required

ID of the customer associated with this contract.

startDate

string<date>

required

Date when the contract becomes active.

endDate

string<date> | null

required

Optional date when the contract expires. If null, the contract has no end date.

retroactiveDate

string<date> | null

required

Optional retroactive date to apply contract changes from a past date.

status

enum<string>

required

Current status of the contract.

Available options:

active,

canceled,

completed,

draft

rateAdjustmentIndex

null | enum<string>

required

Reference index (e.g. IPCA) used to filter contracts when applying a mass adjustment on contracts.

Available options:

none,

igpm,

ipca,

other,

null

customFields

object

required

Custom fields that can be associated with the entity. The fields must be previously created in the system before they can be used.

Show child attributes

Example:

{
  "customField1": "value1",
  "customField2": ["value2", "value3"]
}

invoiceAllocationStrategy

enum<string>

required

Invoice allocation strategy configured for the contract.

Available options:

single,

percent_split,

subsidiary_usage_split

includeNewSubsidiariesOnUsageScope

boolean

required

Whether future subsidiaries are automatically included in usage scope.

usageScopes

object[]

required

Customers that compose the usage scope for this contract.

Minimum array length: 1

Show child attributes

allocations

object[]

required

Payment account allocation configuration.

Minimum array length: 1

Show child attributes

billingSchedule

object

required

Schema defining billing schedule for a contract.

Show child attributes

planInstances

object[]

required

The plan instances attached to the contract. While the contract is draft or active only its active plan instances are listed; once the contract is completed or canceled, all of them are.

Show child attributes

legalEntityId

string<uuid> | null

ID of the legal entity associated with this contract. Optional on create; defaults to the tenant's default legal entity when absent.

legalEntity

object

Legal entity summary embedded on contract responses.

Show child attributes

taxRegimeId

string<uuid> | null

ID of the tax regime applied to invoices generated from this contract. Null when no regime is attached.

autoIssue

boolean

When true, invoices produced at billing-cycle close are issued automatically instead of waiting in review. Defaults to false when omitted; omitting it on update leaves the current value unchanged.

billingSettings

object | null

Schema defining billing settings for a contract.

Show child attributes

paymentGatewaySettings

object | null

Schema defining payment gateway settings for a contract.

Show child attributes