Skip to content

Intake Field Reference

This page lists every field on the Invoice Inbox form in PayInvoice Next with its purpose and usage.

Header Fields

FieldRequiredDescription
SeriesYesAuto-generated numbering series for Invoice Inbox records (format: INB-.YYYY.-).
Tracking NumberRead-onlyUnique identifier assigned automatically when the record is created. Use this to track the invoice through every processing stage.
Source ChannelYesHow the invoice arrived. Options: Email, API, Portal, Batch, Portal Upload, GSTR-2B, Manual Upload, Digital Mailroom. Defaults to "Manual Upload".
Source ReferenceNoReference from the source system — for example, the email message ID or API request ID.
Batch ReferenceRead-onlyIf this invoice was part of a batch upload, this links to the IPU Batch record.
External ReferenceNoA reference provided by the supplier or external system (e.g., the supplier's own invoice number). Useful for searching.
StatusRead-onlyCurrent processing stage. See the Status Values table below.
CompanyNoYour company. Auto-selected in single-company setups.
Received OnRead-onlyDate and time the invoice was received. Set automatically.

Status Values

StatusMeaning
PendingInvoice received, not yet sent for data extraction.
OCR ProcessingData extraction is in progress. The page auto-refreshes while in this state.
OCR CompletedExtraction successful. The invoice is ready for IPU record creation.
OCR FailedExtraction encountered an error. Check the Error Details section for the reason.
Pending PDFUsed for Digital Mailroom records where e-invoice data arrived before the PDF. Waiting for PDF attachment.
ProcessedIPU record has been created. The invoice has moved to the matching stage.
DuplicateThe system detected this invoice has already been submitted.
RejectedThe invoice was rejected during processing. Check Error Details for the reason.

Invoice File Section

FieldRequiredDescription
Invoice FileConditionalThe uploaded invoice document (PDF, JPEG, or PNG). Required for all channels except Digital Mailroom.
File NameRead-onlyName of the attached file.
File TypeRead-onlyFormat of the attached file (e.g., application/pdf).
File Size (bytes)Read-onlySize of the attached file in bytes.

Sender Information Section

These fields are populated automatically for email-sourced invoices. Hidden for other channels.

FieldDescription
Sender EmailEmail address from which the invoice was sent.
Sender NameName of the sender as it appeared in the email.
Email SubjectSubject line of the source email.
Email Received DateDate and time the email was received by the mail server.

OCR Processing Section

FieldDescription
OCR Request IDInternal identifier linking this record to the OCR processing request.
OCR Started AtTimestamp when data extraction began.
OCR Completed AtTimestamp when data extraction finished.
OCR Retry CountNumber of times OCR has been attempted on this record. Increments on each retry.
OCR ConfidencePercentage (0–100%) indicating the OCR engine's confidence in the extracted data. Higher values mean more reliable extraction.

Error Details Section

Visible when the status is "OCR Failed", "Rejected", or when an OCR warning exists.

FieldDescription
Error MessageDescription of what went wrong during processing.
OCR WarningNon-fatal warning from the OCR engine (e.g., low confidence on certain fields).

Compliance Status Section

FieldDescription
Compliance StatusOverall compliance check result. Options: Not Started, Pending, Validating, Compliant, Non-Compliant, Manual Review.
Compliance Risk LevelRisk rating based on compliance checks. Options: Low, Medium, High, Critical.
Compliance ScorePercentage score from compliance validation.

Supplier Matching Section

FieldDescription
Supplier MatchedWhether the system successfully identified the supplier (Yes/No).
Supplier Match MethodHow the supplier was identified. Options: GSTIN, PAN, Email, Name, Manual.
Supplier Match ConfidencePercentage confidence in the supplier match. GSTIN matches typically have the highest confidence.

GST Validation Section

FieldDescription
GSTIN ValidatedWhether the supplier's GSTIN was verified against the GST portal.
GSTIN Validation StatusResult of GSTIN verification. Options: Active, Suspended, Cancelled, Not Found, Error.
IRN NumberInvoice Reference Number from e-invoice data (if available).
IRN VerifiedWhether the IRN was verified against the e-invoice portal.

Matching Section

FieldDescription
Match StatusCurrent state of three-way matching. Options: Not Started, In Progress, Matched, Partial Match, Mismatch, Duplicate.
Match ScoreOverall match percentage from the matching engine.
Match ResultLink to the detailed IPU Match Result record (created during matching).
FieldDescription
IPU ReferenceLink to the Invoice Processing Unit record created from this inbox entry. Appears after the status changes to "Processed".

PayInvoice Next — P2P Documentation v1.0.0-beta