Approve a draft invoice

POST/lokta-lms/api/v1/draft-invoices/{id}/approval

Approves a draft invoice, which creates the invoice and gives it an invoice number.

Mints the gap-free GST invoice number, creates the invoice already approved (GST from the partner's treatment at approval), links it to the draft and marks the accruals invoiced. Refused with 409 sourcing/draft_already_decided once decided, and with 422 sourcing/checker_is_maker when the caller produced the draft (never for a batch draft). Requires an Idempotency-Key.

When to use it

Approve a draft once you have checked its evidence. Approval creates the invoice.

Worth knowing

The person who produced a draft cannot approve it: 422 sourcing/checker_is_maker. A draft produced by the monthly batch is never refused for this.
A draft that was already decided returns 409 sourcing/draft_already_decided.
Send an Idempotency-Key header.

Path parameters

idpath · string · required

Header parameters

Idempotency-Keyheader · string · optional

Per-intent key

Responses

defaultdefault response

Every request authenticates with HTTP Basic and carries a Tenant-Identifier header. See the conventions for dates, commands, pagination and errors. Open this operation in the interactive explorer, or read it as Markdown.

This is the API reference for Lokta, the agentic loan servicing platform. Go to lokta.ai

import requests response = requests.post( "https://default.lokta.tech/lokta-lms/api/v1/draft-invoices/{id}/approval", auth=("{username}", "{password}"), headers={"Tenant-Identifier": "default"}, ) print(response.json())

const response = await fetch("https://default.lokta.tech/lokta-lms/api/v1/draft-invoices/{id}/approval", { method: "POST", headers: { Authorization: "Basic " + Buffer.from("{username}:{password}").toString("base64"), "Tenant-Identifier": "default", }, }); console.log(await response.json());

HttpClient client = HttpClient.newHttpClient(); HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://default.lokta.tech/lokta-lms/api/v1/draft-invoices/{id}/approval")) .header("Authorization", "Basic " + Base64.getEncoder().encodeToString("{username}:{password}".getBytes())) .header("Tenant-Identifier", "default") .method("POST", HttpRequest.BodyPublishers.noBody()) .build(); HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body());

req, _ := http.NewRequest("POST", "https://default.lokta.tech/lokta-lms/api/v1/draft-invoices/{id}/approval", nil) req.SetBasicAuth("{username}", "{password}") req.Header.Set("Tenant-Identifier", "default") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() data, _ := io.ReadAll(res.Body) fmt.Println(string(data))