POP → ZohoInstall

Summary

Validate signed POP API payloads and map invoice or credit note data to Zoho Invoice or Zoho Books. In live mode, resolve or create the customer contact, then create the document; in dry-run mode, return the mapped Zoho request body without calling Zoho.

Inputs

• Input item JSON (required) — Provide the POP payload directly or in body. It must include signature headers (X-POP-Signature, X-POP-Timestamp) and a valid _pop_jwt; its data must include invoice document type (TD01 for invoice or TD04 for credit note), date, currency, customer personal data, and a non-empty order_items array.
• POP API URL — Base URL used to fetch the POP RSA public key from the instance; defaults to https://popapi.io.
• POP API License Key (required) — Secret used to verify the payload HMAC signature.
• POP API RSA Public Key Name or ID (required) — Public key used to verify the payload JWT. The node can fetch a key from the POP API URL.
• Dry Run (No Zoho Calls) — Defaults to false. When enabled, validates and maps the payload without Zoho API calls or Zoho credentials. A signed _pop_dry_run payload value, when present, overrides this setting.
• Contact Match Strategy — Defaults to VAT/TRN, then email, then company/person name. Alternatively, search by email then name.
• Create Contact If Missing — Defaults to true. In live mode, create a Zoho customer contact if searches find no match; otherwise, return an error.
• Invoice Status — Sets the invoice status to Draft or Sent; defaults to Draft. Sent invoices are marked sent after creation. Credit notes use the selected status in their request body.
• Send Email to Customer — Defaults to false. When enabled, includes Zoho's organization email sending option in the document request.
• Place of Supply — Optional supply code included in the Zoho request. Choose a listed UAE emirate or select Other and provide a code.
• Place of Supply Code — Used when Place of Supply is Other.
• Deferred Payment Terms (Days) — Defaults to 30. Applied when the POP payment term is deferred (TP02); immediate terms (TP01 or TP03) map to zero days.
• Zoho credentials — Required for live processing: configure Zoho Invoice or Zoho Books, region, and organization ID, along with OAuth2 access. Dry runs do not use these credentials.

Output shape

One output item per input item, paired to its input.

Dry-run items return success, status_code, message, dry_run, zoho_endpoint, and the mapped zoho_body. Live items return success details including Zoho product, document type, ID, number, status, total, and contact ID/creation flag. Credit notes are created for TD04; their reference invoice ID and date are mapped when present. With Continue On Fail, per-item failures return success: false and an error message; otherwise errors can produce a single error item.

Links

• n8n community nodes installation guide