Vendors (Carriers)

The Vendors section is part of Pelcro’s Accounts Payable (AP) – Beta functionality. It allows admin users to centrally manage vendor records that are used for creating and tracking bills within the platform.

This guide covers how to access, create, and manage vendors.

Where to Find Vendors

Navigate to:

Payables → Vendors

This section is available only to admin users.

Overview

The Vendors module allows you to:

• Maintain a centralized list of all vendors
• Create and update vendor profiles used in bill creation
• Search, filter, and sort vendors for faster access
• Ensure consistent vendor data across AP workflows

Vendor records serve as the foundation for bill creation in the AP system.

Vendors List View

The Vendors list provides:

• A table view of all vendors
• Search by vendor name or email
• Sorting and filtering options for easier navigation

From this view, admins can:

• View vendor details
• Edit existing vendors
• Delete vendors (if not restricted by usage)

Creating a vendor

To create a vendor record that you can use in bill creation:

1. Go to Accounts Payable → Vendors.
2. Click Create Vendor.
3. Enter the vendor’s core details.

Optional: Add financial information

Add Financial Information if you want to store payout details for the vendor:

• Account holder name
• Bank name
• Routing / transit number
• Account number
• Account type (Checking or Savings)
• Currency
• Country

4. Click Save.

Configure vendor routes & rates

When creating or editing a vendor, you can define how deliveries are assigned and routed using delivery zone prompts and delivery sequencing.

Delivery Rules

The Delivery Rules prompt defines two things for a vendor in plain language:

1. Coverage — the delivery area used to automatically assign the vendor to shipping addresses.
2. Billing rates — the commission paid per delivered copy and the deductions applied for missed deliveries.

Because rates live in the same prompt, no separate rate-configuration screen is needed — the amounts you write here are what the billing run uses to calculate each vendor's bill.

Steps

1. Open the vendor record
2. Add or edit the Delivery Rules prompt
3. Describe the coverage area using standard mailing formats:
   • ZIP code ranges (e.g., 04401–04412)
   • Street address ranges (e.g., Main St 100–399)
   • City or county names (e.g., Bangor, Penobscot County)
4. State the commission rate per delivered copy
5. State any missed-delivery deductions by code (see Missed Deliveries below)
6. Click Save

How it works

• Coverage rules assign the vendor to matching shipping addresses, exactly as before — specific rules (street ranges) take priority over general ones (city-level), and unmatched addresses stay unassigned.
• The commission rate is applied to every delivered copy attributed to the vendor within a billing cycle.
• A deduction is applied only for missed deliveries whose code is named in the prompt. Missed deliveries with codes you did not list, or that you explicitly mark as non-chargeable, do not reduce the bill.

Example

Covers ZIP codes 1000 to 2000. Carrier commission $0.37 per copy. Deduct $0.37 per missed delivery coded MD1. No deduction for missed deliveries coded MD4.

In this example the vendor earns $0.37 for each delivered copy, loses $0.37 for each MD1 miss, and is unaffected by MD4 misses.

Screenshot: Delivery Rules prompt on the vendor record

Missed Deliveries & Deduction Codes

Missed deliveries reduce a vendor's bill only when they are recorded against a subscriber's fulfillment with a code, and that code is listed as a deduction in the vendor's Delivery Rules.

Recording a missed delivery

1. Open the subscriber and locate the relevant fulfillment
2. Mark the fulfillment as a misdelivery
3. Set the reason to Other
4. Enter the missed-delivery code (e.g., MD1)
5. Save

How it affects the bill

• When billing runs for the cycle, each recorded missed-delivery code is checked against the vendor's Delivery Rules.
• If the code is listed as a deduction, the configured amount is subtracted from that vendor's net payable.
• If the code is not listed (or is defined as non-chargeable), it is counted for reporting but does not reduce the bill.

Configure Delivery Sequence

The Driver Delivery Sequence defines the order in which deliveries are performed for a driver within a route.

This value is set at the address level when creating or editing a Shipping address, and is used during vendor routing and fulfillment.

• Lower numbers are delivered first
• Higher numbers are delivered later
• If no sequence is provided, delivery order may be determined automatically

This value is included in fulfillment exports and helps preserve delivery route sequencing.

For instructions on how to set this value, see Creating an Address.

Reassign Vendors in Bulk (AI Agent)

You can reassign addresses from one vendor to another in bulk using natural language, instead of updating each address one by one.

How It Works

1. Ask the AI Agent to reassign addresses, for example: "Move all addresses assigned to Vendor A to Vendor B."
2. The agent identifies the source vendor, destination vendor, and the addresses in scope.
3. Before making any changes, the agent shows you a summary — source vendor, destination vendor, and number of affected addresses — and asks for confirmation.
4. Once confirmed, only the vendor assignment is updated; all other address details stay the same.

Vendor Reassignment History

Every time an address is reassigned between vendors — whether individually or in bulk — Pelcro keeps a record of the change.

• A new Previous vendor column shows which vendor an address was most recently reassigned away from.
• A Revert action lets you restore an address to its previous vendor in a single step.

This makes it easy to move addresses back to their original vendor after a temporary reassignment, without having to track the change manually.

Carrier Tips

Pelcro supports recurring carrier tips for print subscriptions, allowing subscribers to optionally tip their delivery driver as part of their subscription billing cycle.

Enabling Carrier Tips

Before tips can be collected, the feature must be enabled at the platform level:

1. Go to Settings → Billing
2. Locate the Vendor Tips toggle
3. Enable the feature
4. Click Save

Once enabled, carrier tips can be configured at the subscription level from both the platform and your website.

How Carrier Tips Work

• Tips are billed as a separate line item on the subscriber's invoice alongside their subscription
• Tips are non-taxable and non-discountable by default
• The tip is applied to the vendor assigned to the subscriber's delivery address
• Each tip automatically generates an AP Bill under the corresponding vendor for reconciliation

Adding a Carrier Tip from the Platform

You can configure a carrier tip when creating or renewing a subscription from the platform:

1. Open the subscription creation or renewal flow
2. Locate the Carrier Tip field
3. Enter the tip amount
4. Choose whether the tip should be recurring (charged every billing cycle) or one-time
5. Complete the subscription creation or renewal

To remove a recurring tip from an existing subscription:

1. Open the Subscription Details page
2. Click on Update subscription
3. Remove or cancel the recurring tip

Adding a Carrier Tip from the Website

Subscribers can also manage their own carrier tip directly on your website:

• During checkout or subscription management, subscribers can opt in to add a carrier tip
• They can choose to make the tip recurring or apply it as a one-time charge

Note: The carrier tip input field will only appear on checkout once a carrier has been assigned to the subscriber's delivery address.

Tip-to-Bill Flow

Once a tip is collected:

1. The tip appears as a separate line item (vendor_tip) on the subscriber's invoice
2. Upon successful payment, Pelcro automatically creates an AP Bill under the assigned vendor
3. The bill references the source invoice for full traceability
4. Publishers settle vendor payments through their existing AP workflows and mark bills as paid in Pelcro

Editing a vendor

Admins can update vendor information at any time:

• Open the vendor from the list view
• Edit supported fields
• Save changes

All updates are reflected immediately and apply to future bill creation.

Deleting a vendor

Admins may delete vendors when appropriate.

Note: Deletion behavior may be restricted if the vendor is already associated with existing bills.

Vendor ACH / NACHA Export (Beta)

The Vendor ACH (NACHA) Export allows you to generate a payment file used by banks to process bulk vendor payouts via ACH.

This file follows the NACHA standard format, which is required for secure and compliant electronic payments between financial institutions.

How It Works

1. Navigate to Accounts Payable → Vendors
2. Click Export Payment Batch
3. Pelcro will:
   • Identify vendors eligible for payout (negative balance + ACH enabled)
   • Calculate payable amounts per vendor
   • Generate a payment batch
4. A NACHA file is generated containing:
   • Vendor banking details
   • Payment amounts
   • Internal reference IDs
5. Download the file and upload it to your bank to process payments

Vendors without valid ACH details are automatically excluded from the export.

Requirements

To generate ACH / NACHA exports, you must configure:

1. Vendor ACH Details

Each vendor must have valid banking information:

• Account number (securely stored)
• Routing number
• Account type
• Authorization status

2. Your ACH Configuration (Required)

You must configure your company’s ACH originator details before exporting.

👉 Go to: Settings → ACH Configuration

This includes:

• Company name
• Bank routing number
• Bank name
• Federal Tax ID (EIN)
• Entry description (e.g., “VENDOR PAY”)

Without this configuration, NACHA exports cannot be generated.

Beta limitations

The Vendors module is currently in Beta and includes the following limitations:

• No vendor self-serve access
• No public OpenAPI or SDK exposure
• No accounting system integrations
• No tax or multi-currency support

What’s next

After you create vendors, you can use them to create and manage bills in Accounts Payable → Bills.

Related guide

• Bills — Create bills, add line items, generate PDFs, and manage bill statuses.