Get sales invoice
One sales invoice with its lines, taxes, totals and status.
MCP tool erpnext_read → get_sales_invoice
read
Returns the full invoice: customer, dates, every item line with quantity, rate and amount, the tax rows, net and grand totals, outstanding amount and status. docstatus is 0 for a draft, 1 for a submitted invoice and 2 for a cancelled one.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice string required | string | Sales Invoice ID from list_sales_invoices or create_sales_invoice. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "erpnext_read",
"arguments": {
"operation": "get_sales_invoice",
"arguments": {
"invoice": "invoice"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice": "ACC-SINV-2026-00036",
"customer": "Lumen Dental",
"status": "Overdue",
"docstatus": 1,
"posting_date": "2026-09-17",
"due_date": "2026-10-01",
"currency": "USD",
"items": [
{
"item_code": "CONSULT-HR",
"qty": 5,
"rate": 80,
"amount": 400
}
],
"taxes": [
{
"description": "Sales Tax",
"rate": 12.5,
"tax_amount": 50
}
],
"net_total": 400,
"grand_total": 450,
"outstanding_amount": 450
},
"isError": false
}