Supplier Agreement

Template Overview

Template ID: supplier-agreement
Version: 2.0.0

To generate this document, pass the structured data described below into the data property of the /api/v1/documents/generate endpoint.

Data Payload Schema

Field	Type	Requirement	Description & Details
`parties`	`array of objects`	Yes	The entities entering into the agreement. For this template, must contain exactly 2 entities. Uses the standard Parties Schema. Each party also takes a `definition` field: one of `"Supplier"`, `"Client"`.
`service`	`string`	No	What services does the Supplier provide to the Client ? These are the items that the Supplies engages in supplying and distribution. Ex: Food stuff of all kinds.
`currency`	`string`	No	What is the currency of payment? Options: `"NGN"`, `"USD"`, `"GBP"`, `"ZAR"`, `"Others"`
`customCurrency`	`string`	Conditional	Insert the currency Required if `currency` is `"Others"`.
`isDeposit`	`boolean`	No	Is there a deposit to be paid?
`deposit`	`number`	Conditional	How much is being paid as a deposit? Ex: 1000000 Required if `isDeposit` is `true`.
`depositPayment`	`string`	Conditional	When will the deposit be paid? (days) This is the number of days after an order of goods has been confirmed within which the deposit will be paid to the supplier. Ex: 7 days Required if `isDeposit` is `true`.
`isRecurring`	`boolean`	No	Is this a recurring Engagement? If yes, the delivery date will be the date of the first delivery and the agreement will automatically renew after each delivery until either party terminates the agreement. Values: `true` (Recurring), `false` (One time).
`totalPrice`	`number`	No	Total Price This is the price paid to the supplier according to the frequency below. Ex: 100,000
`frequency`	`string`	Conditional	Frequency of delivery If this is a recurring engagement, how often will the deliveries be made? Ex: Weekly, Monthly, Quarterly Options: `"monthly"`, `"daily"`, `"quarterly"` Required if `isRecurring` is `true`.
`balancePayment`	`string`	No	When will the full payment be made? (days) This is the number of days after the Supplier has confirmed that the goods have been dispatched within which the deposit should be paid to the supplier. Ex: 7 days
`goods`	`array of objects`	No	goods Each entry: `name` (string), `quantity` (number), `unitPrice` (number). (Minimum 1 entry.)
`location`	`string`	No	Specified Location Please insert the full address of the delivery location. Ex: 30 Adeola Street, Johannesburg, South Africa
`isSpecific`	`boolean`	No	Is there a specific delivery date?
`deliveryDate`	`string`	Conditional	Delivery Date Ex: 20th January 2023 (Format: `YYYY-MM-DD`.) Required if `isSpecific` is `true`.
`deliveryDays`	`number`	Conditional	How many days after an order is placed should the delivery be made? Ex: 5 Required if `isSpecific` is `false`.
`refund`	`string`	No	When will the Client be entitled to a refund for or replacement of Damaged Goods? This is the number of business days after receiving the goods that the Client can inform the Supplier that one or some of the goods have been damaged and be entitled to either a refund or replacement of the goods. Ex:30
`replacement`	`string`	No	When will the Client be only entitled to a replacement of Damaged Goods? This should be more than the number of days provided above. The intention is that the Client is first entitled to a refund or replacement but after a set number of days they will only be entitled to a replacement of the damaged goods. Ex:45
`lateDelivery`	`boolean`	No	Will a discount be given to the Client for the late delivery of the Goods?
`lateDays`	`number`	Conditional	How many days late? How many Business Days after the Scheduled Delivery Date will be considered ‘late’ and warrant a discount? Required if `lateDelivery` is `true`.
`discount`	`number`	Conditional	Discount Percentage What is the % discount on the fees for the goods that were delivered late Required if `lateDelivery` is `true`.
`dispute`	`boolean`	No	Governing law and Dispute resolution Courts are typically slower and cheaper. While arbitration is a generally faster but more expensive dispute resolution process.. Values: `true` (By Arbitration), `false` (By the court).
`governingLaw`	`string`	No	What is the governing law? Options: `"Nigeria"`, `"South Africa"`, `"Botswana"`, `"United Kingdom"`, `"Kenya"`, `"Mozambique"`, `"UAE"`

Example JSON Payload

Here is an example of a properly formatted data object for the Supplier Agreement template.

{
  "templateId": "supplier-agreement",
  "data": {
    "parties": [
      {
        "definition": "Supplier",
        "isCompany": true,
        "rcName": "Acme Corp",
        "rcAddress": "123 Beta Way",
        "rcCountry": "United States",
        "rcNumber": "12345678",
        "type": "Private Company limited by shares"
      },
      {
        "definition": "Client",
        "isCompany": false,
        "fullName": "Joshua",
        "address": "789 Alpha Ave",
        "rcCountry": "Nigeria"
      }
    ],
    "service": "Food stuff of all kinds",
    "currency": "NGN",
    "isDeposit": true,
    "deposit": 1000000,
    "depositPayment": "7 days",
    "isRecurring": true,
    "totalPrice": 100000,
    "frequency": "Weekly, Monthly, Quarterly",
    "balancePayment": "7 days",
    "goods": [
      {
        "name": "HP OfficeJet Pro 6970 Printer",
        "quantity": 4,
        "unitPrice": 1000000
      }
    ],
    "location": "30 Adeola Street, Johannesburg, South Africa",
    "isSpecific": true,
    "deliveryDate": "20th January 2023",
    "refund": "30",
    "replacement": "45",
    "lateDelivery": true,
    "lateDays": 1,
    "discount": 1,
    "dispute": true,
    "governingLaw": "Nigeria"
  },
  "format": "pdf"
}