PurchaseInvoice

Description

Both known as Purchase Invoices in the API context and in the product interface.
This resource is pivotal for managing payments to suppliers after receiving goods or services and serves as a legally binding documentation of the purchase.

The Purchase Invoices entity utilizes a simplified model that primarily includes key information of the purchase invoice: invoice number, invoice date, fulfillment date, total amount, amount excluding tax, and taxes.
This ensures compliance and contributes to a smoother accounts payable process.

Workflow

1. Create the Invoice and Optionally View or Modify It: Start by creating a purchase invoice using the PurchaseInvoice service.
   Once created, you can view and make any necessary modifications to the invoice before finalizing it.

2. Post the Invoice to Generate Accounting Entries: Proceed with posting the invoice using the PostPurchaseInvoice service.
   Posting the invoice will generate the necessary accounting entries, making the invoice part of the company’s financial records.

3. View the Invoice’s Payment Due Dates: Check the payment due dates and related information using the PurchaseInvoiceOpenItems service.
   This allows you to see when payments are expected and track outstanding amounts for the invoice.

4. Apply Partial or Full Payments to the Invoice: Manage the payments on the invoice by using the PurchaseOpenItemSettlement service.
   You can apply both partial and full payments, keeping track of amounts paid and any remaining balances.

mutation ($values: PurchaseCreateGLDtoInput!) {  
    createPurchaseInvoice(input: $values) {
    id
  }
}

{
  "values": {
    "supplierId": "b647b9e4-6d2a-4c9d-96e3-54be55457096",
    "invoiceDate": "2024-08-19",
    "invoiceNumber": "AA123",
    "totalLiquid": 240,
    "firstDueDate": "2024-08-19T00:00:00+00:00",
    "hasCashVat": false,
    "operationDate": "2024-08-19T00:00:00+00:00",
    "pendingAmount": 240,
    "vatLines": [
      {
        "invoiceDate": "2024-08-19T00:00:00+00:00",
        "totalVat": 40,
        "totalVatBase": 200
        "purchaseAccountingAccountId":"550e8400-e29b-41d4-a716-446655440000",
        "taxGroupId":"123e4567-e89b-12d3-a456-426614174000",
        "taxId":"f47ac10b-58cc-4372-a567-0e02b2c3d479",
        "taxTreatmentId":"9a19d7f2-c524-41fc-9e7f-d59775cd8953"
      }
    ]
  }
}

{
    "data": {
        "createPurchaseInvoice": {
            "id": "e451aff7-074f-4e72-a6fb-4ea25e9d9c64"
        }
    }
}

Header

purchaseInvoices

purchaseInvoices/vatLines

purchaseInvoices/openItems

An Open Item is a financial transaction that allows you to know if it has been fully settled or paid.
Each open item includes detailed information such as the total amount, accumulated amount paid, and the payment due date.

For a single invoice, there can be as many open items as there are different payment installments, which is why openItems is structured as an array to accommodate multiple entries per invoice.

The payment status provides insight into the progress of settling each item.
Additionally, the identifier of the payment method used is provided to track the settlement method.