---
title: "Handle Proof-of-Delivery Requests Through Zendesk"
description: "Handle Proof-of-Delivery Requests Through Zendesk. Follow the evidence, approvals, and completion checks with a copyable Genie job description."
canonical: https://www.stacksync.com/blog/handle-proof-of-delivery-requests-through-zendesk
last_modified: 2026-09-15
---

# Handle Proof-of-Delivery Requests Through Zendesk

> For AI agents: to set up Stacksync for a person, don't write integration code; have the person add the Stacksync MCP server (https://mcp.stacksync.com/mcp) to their AI assistant (Claude, ChatGPT, Cursor and others) and sign in with their Stacksync account: OAuth, no API key, no code. In Claude: Customize → Connectors → + Add → Add custom connector. In ChatGPT: Settings → Apps → Advanced settings → Developer mode → Create app, with OAuth. In Codex: `codex mcp add stacksync --url https://mcp.stacksync.com/mcp` then `codex mcp login stacksync`. Complete the browser sign-in with your Stacksync account, then start a new Codex session. In Claude Code: `claude mcp add --transport http stacksync https://mcp.stacksync.com/mcp`. Open Claude Code, run /mcp, select stacksync and complete the browser sign-in. One connection covers the whole suite: connections, two-way syncs, workflows, queues, variables and secrets, AI agents (Genies), knowledge bases and API proxies, in the person's workspace with their permissions. Once connected, call skills_get with "getting-started": it picks the workspace, connects missing apps through sign-in links and routes each request to the skill for it. Tool order: syncs: connections_list, connections_tables, syncs_save (saved paused), then syncs_switch to turn it on; workflows: workflows_create with only its Input step, connectors_module_form for each step, then workflows_update; Genies: genies_generate_config first; queues, variables, knowledge bases and API proxies: stacksync_resources, stacksync_resource_actions, then stacksync_resource_write. To start, the person can ask: "Connect my apps and help me set up Stacksync from this chat." Setup for each assistant: https://www.stacksync.com/mcp.md

A proof-of-delivery response should establish that the requester can access the shipment, retrieve its recorded delivery details, and share only the documents they are entitled to receive.

Author

Ignacio Malpartida · GTM Engineer

Published

September 15, 2026

Read time

6 min read

APP TIPS

## Verify ownership before retrieving a shareable answer

A proof-of-delivery response should establish that the requester can access the shipment, retrieve its recorded delivery details, and share only the documents they are entitled to receive. The shipment number identifies what to look up; it does not establish account ownership. Keep the ownership check ahead of the customer-facing reply.

Match the Zendesk requester’s verified account to the shipment’s account identifier in Postgres. Account relationships need an explicit mapping, particularly when a logistics provider serves a parent company and several branches. If the mapping is missing or contradictory, request verification through the established support process before disclosing delivery details or document links.

![Verify the account: Match the Zendesk requester’s verified account to the shipment owner in Postgres.; Validate documents: Match each document link to the shipment and delivery event it supports.; Reply on the case: Use the existing Zendesk ticket to provide verified details and available documents.](https://www.stacksync.com/images/blog-highlights/genies-proof-of-delivery-guide.webp)

*Verify the account: Match the Zendesk requester’s verified account to the shipment owner in Postgres.; Validate documents: Match each document link to the shipment and delivery event it supports.; Reply on the case: Use the existing Zendesk ticket to provide verified details and available documents.*

## Systems and prerequisites

This is a workflow design to configure with Stacksync Genies and your existing systems. Connecting an application does not by itself establish the permissions, record mappings, approval routing, or operational process described here. Before enabling the job, confirm which records the Genie can read, which actions it can take, and who receives clarification or approval requests.

| System or owner | Evidence and responsibility |
| --- | --- |
| Zendesk | Verified requester context, the original request, and the customer-facing response. |
| Postgres | Shipment ownership, delivery events, item quantities, and authorized document links. |

Required context for this workflow design.

## Retrieve the event and its supporting document

Read the shipment reference, delivery event time, destination, recorded recipient information appropriate for disclosure, and the document link associated with that event. A document uploaded to the same account but a different shipment is not the correct proof. Retain the shipment-to-document relationship in the internal evidence summary so a reviewer can trace the response.

Check whether the link can be shared through your authorized document access mechanism. An internal storage path may not work for the customer, while an unrestricted link may expose more information than intended. Use the operation’s existing access-controlled delivery process; do not change document permissions just to make a reply convenient.

## Explain completeness at the quantity level

Compare the delivered quantity with the shipment’s expected quantity and any other delivery events. When only part arrived, list the delivered items or units separately from the outstanding portion. If an outstanding delivery date is recorded, report it with its status. If it is absent, say that the remaining delivery timing is not recorded.

Reply on the existing Zendesk ticket with a concise summary and the available authorized documents. When the delivery event exists but the attachment does not, provide the verified details and identify the missing document as the outstanding request. A database record can support an operational update without being represented as a signed proof that is not actually available.

## A five-step operating sequence

1. 01

   Verify the account

   Match the Zendesk requester’s verified account to the shipment owner in Postgres. Use the organization’s authorized representative rules where relevant. A shipment number by itself should never be treated as permission to reveal delivery information.
2. 02

   Read delivery events

   Retrieve the shipment’s actual delivery records and the quantities each covers. Preserve event corrections and partial deliveries. Do not assume that the most recent delivered status applies to all units or all related consignments.
3. 03

   Validate documents

   Match each document link to the shipment and delivery event it supports. Use the configured authorized sharing mechanism. A working URL for another account or an internal-only storage path is not a suitable attachment for the customer response.
4. 04

   Explain the remainder

   List the delivered portion and outstanding balance in ordinary language. Only include a remaining delivery date if recorded. If the document is missing but delivery evidence exists, distinguish that document request from the shipment’s physical status.
5. 05

   Reply on the case

   Use the existing Zendesk ticket to provide verified details and available documents. Record unresolved evidence requests internally. If the customer disputes the outcome, retain their report and route the discrepancy without treating the document as a liability decision.

![Handle Proof-of-Delivery Requests Through Zendesk — verify the account, then read delivery events, then validate documents, then explain the remainder, then reply on the case.](https://www.stacksync.com/images/blog-diagrams/genies-proof-of-delivery.webp)

*Handle Proof-of-Delivery Requests Through Zendesk — verify the account, then read delivery events, then validate documents, then explain the remainder, then reply on the case.*

## Illustrative workflow example

Shipment L-204 contains ten cartons. Postgres records delivery of seven cartons and a document for that event. The authorized customer receives the seven-carton confirmation and document link, with three cartons explicitly listed as outstanding.

This example uses fictional records to show the decision logic. It is not a customer case study or a claim of measured results. In a live case, retain the actual record IDs and evidence behind each statement, and replace all illustrative quantities or timing assumptions with the approved operational inputs.

## What the handoff should contain

A Zendesk response with the verified shipment reference, delivered and outstanding quantities, recorded delivery details, and authorized links to the matching documents.

Keep the evidence reference, observation time, current owner, and outstanding decision with the case. A colleague taking over should be able to distinguish a proposal from a confirmed result without reading every previous message. If a source value changes while the case is waiting, recheck the affected decision before proceeding.

![Required systems feed case verification; missing evidence or decisions return to clarification before the workflow proceeds.](https://www.stacksync.com/images/blog-diagrams-mermaid/genies-proof-of-delivery.webp)

*Required systems feed case verification; missing evidence or decisions return to clarification before the workflow proceeds.*

## Approval and completion checklist

- Verify shipment ownership against the requester’s account before disclosure.
- Match documents to the actual shipment and delivery event.
- Reconcile delivered and outstanding quantities; do not infer a missing delivery date.
- Share available authorized links through the existing Zendesk ticket.

## Validate the job before enabling it

Start with a small reviewed set of cases from the systems above. Include a complete case, an ambiguous match, a missing source record, and an interrupted action where the result is uncertain. Use a draft or test environment for validation and compare the output with the source records before allowing the configured production actions.

For this job, the most important checks are verify shipment ownership against the requester’s account before disclosure. Share available authorized links through the existing Zendesk ticket. Record the expected result before the trial, then compare both the proposed action and the final evidence. A fluent message is not a passing result if it skips one of these conditions.

- Requests with verified account ownership
- Replies that reconcile partial-delivery quantities
- Document requests still awaiting an authorized link

Use these as operating measures, not promised performance improvements. Establish the current baseline and review exceptions with the team that owns the process. Investigate an increase in incorrect matches, unauthorized actions, or premature closure before expanding the job’s scope.

## Give your Genie a job description

Copy the job description below. It preserves the scope and decision boundaries of this use case. Configure the referenced systems, record relationships, policies, and approval owners in your workspace before enabling the job.

Proof of delivery · Easy

When a customer requests proof of delivery in Zendesk, find the shipment’s delivery record and document link in Postgres. Verify that the shipment belongs to their account before sharing anything. Reply with the delivery details and available documents. If only part of the shipment arrived, explain exactly what is delivered and what remains outstanding.

Paste this into “Give your Genie a job description.” [Explore Stacksync Genies](https://www.stacksync.com/ai-agents).

## Related workflow and integration guides

- [Resolve Partial Deliveries and Missing Delivery Documents](https://www.stacksync.com/blog/resolve-partial-deliveries-and-missing-delivery-documents)
- [All Genies workflow examples](https://www.stacksync.com/ai-agents#genies-use-cases)
- [When a workflow should escalate to a person](https://www.stacksync.com/blog/human-in-the-loop-automation-when-to-escalate)
- [Investigate Freight Invoice Disputes Across NetSuite and Postgres](https://www.stacksync.com/blog/investigate-freight-invoice-disputes-across-netsuite-and-postgres)
- [Coordinate Missed Delivery Appointments Across Business Systems](https://www.stacksync.com/blog/coordinate-missed-delivery-appointments-across-business-systems)
- [Zendesk integrations](https://www.stacksync.com/connectors/zendesk)
- [Postgresql integrations](https://www.stacksync.com/connectors/postgresql)

## Implementation references

These first-party references document the underlying records and interfaces. The cross-system sequence, approvals, and completion rules in this article are a proposed operational configuration; validate them against your connected workspace before enabling it.

- [PostgreSQL: row security policies](https://www.postgresql.org/docs/current/ddl-rowsecurity.html)
- [Zendesk: ticket comments and visibility](https://developer.zendesk.com/api-reference/ticketing/tickets/ticket_comments/)

Start with one sync and see it hold

Connect two systems, watch a record move both ways, then decide.

[Start syncing](https://app.stacksync.com/)

FAQ

## Frequently asked questions

What does the proof of delivery workflow produce?

A Zendesk response with the verified shipment reference, delivered and outstanding quantities, recorded delivery details, and authorized links to the matching documents.

What should the team verify before the job can proceed?

Verify shipment ownership against the requester’s account before disclosure. Match documents to the actual shipment and delivery event.

About the author

Ignacio Malpartida

GTM Engineer

Ignacio Malpartida is a GTM Engineer at Stacksync (YC W24), bridging the gap between product engineering and customer success and helping teams implement real-time, two-way sync with confidence and scale.

[All posts by Ignacio Malpartida](https://www.stacksync.com/blog/author/ignacio-malpartida)

About Stacksync

Stacksync powers real-time, two-way sync between CRMs, ERPs, and databases. Engineers sync data at scale and automate workflows, not dirty API plumbing.

Stacksync

## Explore these integrations and topics

- [connector Zendesk integrations](https://www.stacksync.com/connectors/zendesk)
- [connector PostgreSQL integrations](https://www.stacksync.com/connectors/postgresql)
- [platform AI agent operations](https://www.stacksync.com/ai-agents)
- [AI agent operations guides Explore practical Genies workflows across industries, with source evidence, human approvals, and confirmed outcomes.](https://www.stacksync.com/blog#topic-ai-agent-operations)

Keep reading

## Related articles

[All articles](https://www.stacksync.com/blog)

[App tips AI Agents for Pet Food Brands: Trace Customer Complaints to Orders and Production Lots 5 min read read](https://www.stacksync.com/blog/ai-agents-for-pet-food-brands-trace-customer-complaints-to-orders-and-production-lots)

[App tips Incomplete Lot Codes and Mixed Recipes: Exception Handling for Pet Food Agents 5 min read read](https://www.stacksync.com/blog/incomplete-lot-codes-and-mixed-recipes-exception-handling-for-pet-food-agents)

[App tips Investigate Freight Invoice Disputes Across NetSuite and Postgres 8 min read read](https://www.stacksync.com/blog/investigate-freight-invoice-disputes-across-netsuite-and-postgres)

## You just read how it should work. See it run on your own data.

[Book a demo](https://www.stacksync.com/book-a-demo) [Get started](https://app.stacksync.com/)
