# Authentication Source: https://docs.piriod.com/api-reference/authentication How to authenticate requests against the Piriod API. The Piriod API uses **API tokens** combined with a **workspace header**. ## API tokens Tokens are obtained from the Piriod dashboard (Settings → API tokens). Pass the token on every request: ```http theme={null} Authorization: Token sk_live_xxxxxxxxxxxxxxxxxxxxxxxx ``` Do not include the token in client-side code. Treat it as a secret. > [!WARNING] > > Each user has at most one active API token. Generating a new token from the > dashboard invalidates the previous one. ## Workspace header Piriod is multi-workspace: a single user can belong to several accounts. Every request must declare which workspace it operates on: ```http theme={null} x-simple-workspace: acc_01H8XYZ123ABC ``` Requests without this header (or with a workspace the user does not belong to) return `400` or `403`. ## Test mode Set `x-piriod-test-mode: true` to operate against test data — separate from your production data. Resources created in test mode are returned only when this header is `true`. ```http theme={null} x-piriod-test-mode: true ``` ## Publishable keys (payment links) Hosted payment-link endpoints under `/publishable/payment_links/...` are designed to be called from the browser using the link's `publishable_key`. These endpoints do not require `Authorization: Token`. They are read-only or limited to payment-intent operations. ## Putting it all together ```bash theme={null} curl https://api.piriod.com/invoices/ \ -H "Authorization: Token sk_live_xxxxx" \ -H "x-simple-workspace: acc_01H8XYZ123ABC" \ -H "x-piriod-test-mode: false" ``` # Archive addon Source: https://docs.piriod.com/api-reference/billing/addons/archive-addon DELETE /addons/{id}/ # Create addon Source: https://docs.piriod.com/api-reference/billing/addons/create-addon POST /addons/ # List addons Source: https://docs.piriod.com/api-reference/billing/addons/list-addons GET /addons/ # Partial update addon Source: https://docs.piriod.com/api-reference/billing/addons/partial-update-addon PATCH /addons/{id}/ # Retrieve addon Source: https://docs.piriod.com/api-reference/billing/addons/retrieve-addon GET /addons/{id}/ # Create contact Source: https://docs.piriod.com/api-reference/billing/contacts/create-contact POST /contacts/ # Delete contact Source: https://docs.piriod.com/api-reference/billing/contacts/delete-contact DELETE /contacts/{id}/ # List contacts Source: https://docs.piriod.com/api-reference/billing/contacts/list-contacts GET /contacts/ Returns a paginated list of contacts. A customer is limited to seven contacts per organisation unit (or seven without an org unit). # Partial update contact Source: https://docs.piriod.com/api-reference/billing/contacts/partial-update-contact PATCH /contacts/{id}/ # Retrieve contact Source: https://docs.piriod.com/api-reference/billing/contacts/retrieve-contact GET /contacts/{id}/ # Archive coupon Source: https://docs.piriod.com/api-reference/billing/coupons/archive-coupon DELETE /coupons/{id}/ # Create coupon Source: https://docs.piriod.com/api-reference/billing/coupons/create-coupon POST /coupons/ # List coupons Source: https://docs.piriod.com/api-reference/billing/coupons/list-coupons GET /coupons/ # Partial update coupon Source: https://docs.piriod.com/api-reference/billing/coupons/partial-update-coupon PATCH /coupons/{id}/ # Retrieve coupon Source: https://docs.piriod.com/api-reference/billing/coupons/retrieve-coupon GET /coupons/{id}/ # Create credit note (draft) Source: https://docs.piriod.com/api-reference/billing/creditnotes/create-credit-note-draft POST /creditnotes/ Creates a credit note. If the related invoice or chosen document allows partial credit, the line totals are computed from the request; otherwise the lines mirror the invoice. # Delete credit note (draft only) Source: https://docs.piriod.com/api-reference/billing/creditnotes/delete-credit-note-draft-only DELETE /creditnotes/{id}/ # Finalize credit note Source: https://docs.piriod.com/api-reference/billing/creditnotes/finalize-credit-note GET /creditnotes/{id}/finalize/ Submits the credit note to the tax agency (when applicable) and locks the document. # List credit notes Source: https://docs.piriod.com/api-reference/billing/creditnotes/list-credit-notes GET /creditnotes/ # Partial update credit note (draft only) Source: https://docs.piriod.com/api-reference/billing/creditnotes/partial-update-credit-note-draft-only PATCH /creditnotes/{id}/ # Render credit-note PDF Source: https://docs.piriod.com/api-reference/billing/creditnotes/render-credit-note-pdf GET /creditnotes/{id}/pdf/ # Retrieve credit note Source: https://docs.piriod.com/api-reference/billing/creditnotes/retrieve-credit-note GET /creditnotes/{id}/ # Create customer Source: https://docs.piriod.com/api-reference/billing/customers/create-customer POST /customers/ # Delete customer Source: https://docs.piriod.com/api-reference/billing/customers/delete-customer DELETE /customers/{id}/ Soft-archives the customer (sets `status=archived`) when there are non-draft invoices, terminal subscriptions, valuable sources, or abandoned sources with payments. Otherwise hard-deletes the customer and any draft invoices. # List customers Source: https://docs.piriod.com/api-reference/billing/customers/list-customers GET /customers/ Returns a paginated list of customers in the workspace. # Partial update customer Source: https://docs.piriod.com/api-reference/billing/customers/partial-update-customer PATCH /customers/{id}/ # Retrieve customer Source: https://docs.piriod.com/api-reference/billing/customers/retrieve-customer GET /customers/{id}/ # Create debit note Source: https://docs.piriod.com/api-reference/billing/debitnotes/create-debit-note POST /debitnotes/ # Delete debit note Source: https://docs.piriod.com/api-reference/billing/debitnotes/delete-debit-note DELETE /debitnotes/{id}/ # List debit notes Source: https://docs.piriod.com/api-reference/billing/debitnotes/list-debit-notes GET /debitnotes/ # Partial update debit note Source: https://docs.piriod.com/api-reference/billing/debitnotes/partial-update-debit-note PATCH /debitnotes/{id}/ # Retrieve debit note Source: https://docs.piriod.com/api-reference/billing/debitnotes/retrieve-debit-note GET /debitnotes/{id}/ # Create invoice (draft) Source: https://docs.piriod.com/api-reference/billing/invoices/create-invoice-draft POST /invoices/ Creates an invoice in `draft` status. Totals (`amount`, `tax`, `subtotal`, `total`) are computed server-side from the lines. Call `finalize` to issue the invoice to the tax agency and lock it. # Delete invoice (draft only) Source: https://docs.piriod.com/api-reference/billing/invoices/delete-invoice-draft-only DELETE /invoices/{id}/ Only invoices in `draft` status can be deleted. Linked payments are unlinked. # Finalize invoice Source: https://docs.piriod.com/api-reference/billing/invoices/finalize-invoice GET /invoices/{id}/finalize/ Submits the invoice to the tax agency (when applicable) and locks the document. Requires status `draft` or `pending`. When status is `pending` all linked payments must be `succeeded`. # List invoices Source: https://docs.piriod.com/api-reference/billing/invoices/list-invoices GET /invoices/ Returns a paginated list of invoices. The list excludes draft invoices that belong to a subscription, and (unless filtered by `bulk`) invoices attached to a bulk in `pending`, `processing` or `failed` status. # Partial update invoice (draft only) Source: https://docs.piriod.com/api-reference/billing/invoices/partial-update-invoice-draft-only PATCH /invoices/{id}/ # Render invoice PDF Source: https://docs.piriod.com/api-reference/billing/invoices/render-invoice-pdf GET /invoices/{id}/pdf/ Returns the invoice PDF. Uses the fiscal format when the document type has a local biller; otherwise renders a plain HTML-to-PDF template. # Retrieve invoice Source: https://docs.piriod.com/api-reference/billing/invoices/retrieve-invoice GET /invoices/{id}/ # Toggle uncollectible Source: https://docs.piriod.com/api-reference/billing/invoices/toggle-uncollectible GET /invoices/{id}/uncollectible/ Toggles the invoice between `finalized` and `uncollectible`. Sets or clears the `uncollectible` timestamp accordingly. # Create org unit Source: https://docs.piriod.com/api-reference/billing/orgunits/create-org-unit POST /orgunits/ # Delete org unit Source: https://docs.piriod.com/api-reference/billing/orgunits/delete-org-unit DELETE /orgunits/{id}/ Refuses to delete when there are linked contacts or subscriptions; remove them first. # List organisation units Source: https://docs.piriod.com/api-reference/billing/orgunits/list-organisation-units GET /orgunits/ Returns a paginated list of organisation units. A customer can have at most twelve org units; org units are an optional sub-grouping for contacts and subscriptions. # Partial update org unit Source: https://docs.piriod.com/api-reference/billing/orgunits/partial-update-org-unit PATCH /orgunits/{id}/ # Retrieve org unit Source: https://docs.piriod.com/api-reference/billing/orgunits/retrieve-org-unit GET /orgunits/{id}/ # Create payment receipt (draft) Source: https://docs.piriod.com/api-reference/billing/payment-receipts/create-payment-receipt-draft POST /payment-receipts/ # Delete payment receipt (draft only) Source: https://docs.piriod.com/api-reference/billing/payment-receipts/delete-payment-receipt-draft-only DELETE /payment-receipts/{id}/ # Finalize payment receipt Source: https://docs.piriod.com/api-reference/billing/payment-receipts/finalize-payment-receipt GET /payment-receipts/{id}/finalize/ # List payment receipts Source: https://docs.piriod.com/api-reference/billing/payment-receipts/list-payment-receipts GET /payment-receipts/ # Partial update payment receipt (draft only) Source: https://docs.piriod.com/api-reference/billing/payment-receipts/partial-update-payment-receipt-draft-only PATCH /payment-receipts/{id}/ # Retrieve payment receipt Source: https://docs.piriod.com/api-reference/billing/payment-receipts/retrieve-payment-receipt GET /payment-receipts/{id}/ # Archive plan Source: https://docs.piriod.com/api-reference/billing/plans/archive-plan DELETE /plans/{id}/ # Create plan Source: https://docs.piriod.com/api-reference/billing/plans/create-plan POST /plans/ # List plans Source: https://docs.piriod.com/api-reference/billing/plans/list-plans GET /plans/ # Partial update plan (mutable fields) Source: https://docs.piriod.com/api-reference/billing/plans/partial-update-plan-mutable-fields PATCH /plans/{id}/ # Retrieve plan Source: https://docs.piriod.com/api-reference/billing/plans/retrieve-plan GET /plans/{id}/ # Archive product Source: https://docs.piriod.com/api-reference/billing/products/archive-product DELETE /products/{id}/ Soft-deletes the product (sets `status=archived`). Cannot be reused after archive. # Create product Source: https://docs.piriod.com/api-reference/billing/products/create-product POST /products/ # List products Source: https://docs.piriod.com/api-reference/billing/products/list-products GET /products/ # Partial update product Source: https://docs.piriod.com/api-reference/billing/products/partial-update-product PATCH /products/{id}/ # Retrieve product Source: https://docs.piriod.com/api-reference/billing/products/retrieve-product GET /products/{id}/ # Cancel subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/cancel-subscription DELETE /subscriptions/{id}/ If the subscription has no non-draft invoices it is hard-deleted; otherwise it is cancelled (`status=cancelled`, `cancelled` timestamp set) and a `cancel_reason` is recorded (defaults to `not_specified`). # Create subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/create-subscription POST /subscriptions/ # List subscriptions Source: https://docs.piriod.com/api-reference/billing/subscriptions/list-subscriptions GET /subscriptions/ # Partial update subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/partial-update-subscription PATCH /subscriptions/{id}/ # Pause subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/pause-subscription POST /subscriptions/{id}/pause/ # Resume subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/resume-subscription POST /subscriptions/{id}/resume/ # Retrieve subscription Source: https://docs.piriod.com/api-reference/billing/subscriptions/retrieve-subscription GET /subscriptions/{id}/ # List usages Source: https://docs.piriod.com/api-reference/billing/usages/list-usages GET /usages/ # Record usage Source: https://docs.piriod.com/api-reference/billing/usages/record-usage POST /usages/ # List exchange rates Source: https://docs.piriod.com/api-reference/collections/generals/changes/list-exchange-rates GET /generals/changes/ Historical exchange rates between currencies. # List countries Source: https://docs.piriod.com/api-reference/collections/generals/countries/list-countries GET /generals/countries/ Reference catalogue of supported countries. # List currencies Source: https://docs.piriod.com/api-reference/collections/generals/currencies/list-currencies GET /generals/currencies/ Reference catalogue of currencies. Public endpoint — does not require authentication or workspace headers. # List document types Source: https://docs.piriod.com/api-reference/collections/generals/documents/list-document-types GET /generals/documents/ Reference catalogue of fiscal document types per country. # List document reference types Source: https://docs.piriod.com/api-reference/collections/generals/references/list-document-reference-types GET /generals/references/ Reference catalogue of document-reference types (used to link an invoice to a previous document, e.g. credit notes). # List states / provinces Source: https://docs.piriod.com/api-reference/collections/generals/states/list-states-provinces GET /generals/states/ # Error handling Source: https://docs.piriod.com/api-reference/error-handling Status codes and response shapes when something goes wrong. ## Status codes | Code | Meaning | | - | - | | `200` | OK. Returned on `GET`, `PATCH`, `PUT` and most action endpoints. | | `201` | Created. Returned on `POST` for new resources. | | `204` | No Content. Returned on `DELETE`. | | `400` | Bad Request. Validation error (see body). | | `401` | Unauthorized. Missing or invalid `Authorization` header. | | `403` | Forbidden. Authenticated but not allowed (e.g. wrong workspace). | | `404` | Not Found. Either the resource does not exist or it does not belong to the workspace. | | `405` | Method Not Allowed. The HTTP verb is not supported by the endpoint. | | `500` | Internal Server Error. Open a support ticket if it persists. | ## Response shapes ### Generic errors For `401`, `403`, `404` and most `500` cases: ```json theme={null} { "detail": "Authentication credentials were not provided." } ``` ### Validation errors For `400`, errors are returned as a field-keyed map. Errors not bound to a single field are grouped under `non_field_errors`: ```json theme={null} { "name": ["This field is required."], "tax_id": ["Invalid format."], "non_field_errors": ["x-simple-workspace header is required."] } ``` ## Common pitfalls * **`x-simple-workspace` missing** → `400` with `non_field_errors: ["x-simple-workspace header is required."]`. * **Wrong workspace ID** → `403` (the user is not a member of that workspace). * **Tax-regulated country, missing `tax_id` or `tax_settings`** → `400` with field-specific errors. * **Trying to delete a customer with active subscriptions** → `400`. Cancel the subscriptions first or the customer is archived instead. ## Retries The API does not currently support an idempotency header. Treat write requests as non-idempotent and avoid blind retries on `5xx` for endpoints that create financial records. # Integration flows Source: https://docs.piriod.com/api-reference/integration-flows End-to-end scenarios for the most common Piriod use cases. This page describes the most common flows. Each step links to the relevant API Reference entry. ## 1. One-shot billing: customer → invoice → payment **1. Create a customer** POST `/customers/` with `name`, `address`, `country`, `state` and (when applicable) `tax_id` + `tax_settings`. The response includes a customer `id` you will reuse below. **2. Issue an invoice** POST `/invoices/` with the `customer` id and the line items. The invoice starts in `draft` status. **3. Finalize the invoice** Call the `finalize` action on the invoice to send it to the tax agency (when applicable) and lock its content. **4. Charge the customer** POST `/payments/` linking the invoice and a reusable `source`, or share a payment link from `/payment_links/links/` for hosted checkout. ## 2. Recurring billing with subscriptions **1. Define your catalog** Create products at `/products/`, plans at `/plans/` and optional add-ons or coupons. **2. Subscribe a customer** POST `/subscriptions/` with the customer, the plan and the chosen frequency. Piriod will compute the next billing date. **3. Generate invoices automatically** Each cycle Piriod generates the invoice; the matching webhook event lets you react. You can also call the `process` action manually. **4. Pause, resume or cancel** Use `pause`, `resume` and `DELETE` on the subscription resource. ## 3. Hosted payment links **1. Create a link** POST `/payment_links/links/` with the amount and currency. Capture the `publishable_key` from the response. **2. Share the hosted page** Send `/publishable/payment_links/links/{key}/hosted/` to the payer. They complete the checkout in Piriod-hosted UI. **3. Track the result** The created `intent` exposes status transitions (authorized → captured → finalized) you can poll or listen for via webhook. ## 4. Procurement: receive supplier documents **1. Register a supplier** POST `/suppliers/` with their tax identifier and contact info. **2. Record a purchase** POST `/purchases/` (or `/purchases/credit-notes/` for credit notes) with the supplier and line items. **3. Issue retentions** POST `/retentions/` linked to the purchase when withholding taxes apply. **4. Finalize and report** Call `finalize` on each document to submit it to the tax agency. # Introduction Source: https://docs.piriod.com/api-reference/introduction Welcome to the Piriod API. Piriod is a billing, payments, procurement and collections platform. The API exposes the same building blocks our dashboard uses, so you can issue invoices, charge cards, manage subscriptions and reconcile payments programmatically. ## Base URL ```text Production theme={null} https://api.piriod.com ``` ```text Development theme={null} https://api.dev.piriod.com ``` ## Required headers on every request | Header | Required | Description | | - | - | - | | `Authorization` | Yes | `Token `. See [Authentication](/authentication). | | `x-simple-workspace` | Yes | The workspace (account) identifier you are operating on. | | `x-piriod-test-mode` | No | `true` to use test-mode data. Defaults to `false`. | ## Hello world ```bash theme={null} curl https://api.piriod.com/customers/ \ -H "Authorization: Token sk_live_xxxxx" \ -H "x-simple-workspace: acc_01H8XYZ123ABC" ``` The response is a paginated list of customers; see [Pagination and filtering](/pagination-filtering). ## What's next * [Integration flows](/integration-flows) walks you through end-to-end scenarios. * [Authentication](/authentication) explains tokens and workspaces. * [Error handling](/error-handling) covers the response shape on failures. * The **API Reference** tab lists every endpoint grouped by section. # Pagination and filtering Source: https://docs.piriod.com/api-reference/pagination-filtering Working with list endpoints: pagination, filters, ordering and search. ## Pagination List endpoints return a paginated payload: ```json theme={null} { "count": 142, "next": "https://api.piriod.com/customers/?page=2", "previous": null, "results": [ /* items of the current page */ ] } ``` Control pagination with query parameters: | Parameter | Type | Default | Notes | | - | - | - | - | | `page` | integer | `1` | 1-indexed page number. | | `page_size` | integer | `20` | Items per page (max `100`). | ```bash theme={null} curl "https://api.piriod.com/customers/?page=2&page_size=50" \ -H "Authorization: Token sk_live_xxxxx" \ -H "x-simple-workspace: acc_..." ``` ## Filtering Filters are exposed as query parameters. Each list endpoint declares the filterable fields in the API Reference (see the Parameters tab). For example, `GET /customers/` accepts `country`, `email`, `name`, `tax_id`, `created`, `subscriptions`, `sources`. Common patterns: ```bash theme={null} # exact match ?status=active # range (date or numeric fields) ?created__gte=2026-01-01&created__lte=2026-01-31 # membership ?status__in=draft,finalized # nested foreign keys ?customer=cus_01H8XYZ123ABC ``` ### Filtering by metadata Resources that expose a `metadata` field accept arbitrary filters using the `metadata__` pattern: ```bash theme={null} ?metadata__order_id=12345 ``` ## Ordering Use `ordering` to sort the results. Prefix the field name with `-` for descending order: ```bash theme={null} ?ordering=name ?ordering=-created ``` Each list endpoint declares its supported ordering fields. ## Search Some endpoints expose `search` for free-text matching across configured fields: ```bash theme={null} ?search=acme ``` # Create ACH adjustment Source: https://docs.piriod.com/api-reference/payments/ach_transfers/adjustments/create-ach-adjustment POST /ach_transfers/adjustments/ # Delete ACH adjustment Source: https://docs.piriod.com/api-reference/payments/ach_transfers/adjustments/delete-ach-adjustment DELETE /ach_transfers/adjustments/{id}/ Reverses the adjustment on the parent transfer. The transfer must be `pending`. # List ACH adjustments Source: https://docs.piriod.com/api-reference/payments/ach_transfers/adjustments/list-ach-adjustments GET /ach_transfers/adjustments/ # Archive ACH transfer Source: https://docs.piriod.com/api-reference/payments/ach_transfers/archive-ach-transfer DELETE /ach_transfers/{id}/ Archives the transfer (status `pending` only). Sets `status=archived` and an `archived` timestamp. # List ACH transfers Source: https://docs.piriod.com/api-reference/payments/ach_transfers/list-ach-transfers GET /ach_transfers/ Lists ACH transfers. By default, archived transfers are excluded; pass `status=archived` to include them. # Retrieve ACH transfer Source: https://docs.piriod.com/api-reference/payments/ach_transfers/retrieve-ach-transfer GET /ach_transfers/{id}/ # Create boleto Source: https://docs.piriod.com/api-reference/payments/boletos/create-boleto POST /boletos/ # Delete boleto Source: https://docs.piriod.com/api-reference/payments/boletos/delete-boleto DELETE /boletos/{id}/ # List boletos Source: https://docs.piriod.com/api-reference/payments/boletos/list-boletos GET /boletos/ # Retrieve boleto Source: https://docs.piriod.com/api-reference/payments/boletos/retrieve-boleto GET /boletos/{id}/ # Authorize payment (publishable) Source: https://docs.piriod.com/api-reference/payments/payments/authorize-payment-publishable POST /payments/{id}/authorize/ Public endpoint used during a checkout flow. Attaches a `source` to the payment and authorizes the gateway transaction. Does **not** require authentication; the payment is found by its ID alone, so its `enable_checkout` flag must be `true`. # Create payment Source: https://docs.piriod.com/api-reference/payments/payments/create-payment POST /payments/ # Delete payment Source: https://docs.piriod.com/api-reference/payments/payments/delete-payment DELETE /payments/{id}/ Refuses to delete payments in `succeeded` or `processing` status, or payments linked to an invoice. # List payments Source: https://docs.piriod.com/api-reference/payments/payments/list-payments GET /payments/ # Retrieve payment Source: https://docs.piriod.com/api-reference/payments/payments/retrieve-payment GET /payments/{id}/ # Create refund Source: https://docs.piriod.com/api-reference/payments/refunds/create-refund POST /refunds/ Issues a refund against a payment. The total of refund amounts cannot exceed the payment's amount. # Create source (publishable) Source: https://docs.piriod.com/api-reference/payments/sources/create-source-publishable POST /sources/ Creates a payment source. This endpoint accepts unauthenticated calls from the browser (publishable flow), so the request is identified by the gateway/customer/payment context rather than a workspace header. # Delete or finalize source Source: https://docs.piriod.com/api-reference/payments/sources/delete-or-finalize-source DELETE /sources/{id}/ For reusable sources: detaches the tokenization at the gateway and either finalizes the source (when it has linked payments) or hard- deletes it. For single-use sources tied to ACH transfers, releases the balance back to the transfer. Refuses to delete other single-use sources. # List sources Source: https://docs.piriod.com/api-reference/payments/sources/list-sources GET /sources/ # Retrieve source Source: https://docs.piriod.com/api-reference/payments/sources/retrieve-source GET /sources/{id}/ # Create cancellation Source: https://docs.piriod.com/api-reference/procurement/cancellations/create-cancellation POST /cancellations/ # List cancellations Source: https://docs.piriod.com/api-reference/procurement/cancellations/list-cancellations GET /cancellations/ # Retrieve cancellation Source: https://docs.piriod.com/api-reference/procurement/cancellations/retrieve-cancellation GET /cancellations/{id}/ # Create order (draft) Source: https://docs.piriod.com/api-reference/procurement/orders/create-order-draft POST /orders/ # Delete order Source: https://docs.piriod.com/api-reference/procurement/orders/delete-order DELETE /orders/{id}/ # Finalize order Source: https://docs.piriod.com/api-reference/procurement/orders/finalize-order GET /orders/{id}/finalize/ # List orders Source: https://docs.piriod.com/api-reference/procurement/orders/list-orders GET /orders/ # Partial update order Source: https://docs.piriod.com/api-reference/procurement/orders/partial-update-order PATCH /orders/{id}/ # Render order PDF Source: https://docs.piriod.com/api-reference/procurement/orders/render-order-pdf GET /orders/{id}/pdf/ # Retrieve order Source: https://docs.piriod.com/api-reference/procurement/orders/retrieve-order GET /orders/{id}/ # Create purchase (draft) Source: https://docs.piriod.com/api-reference/procurement/purchases/create-purchase-draft POST /purchases/ # Create purchase credit note (draft) Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/create-purchase-credit-note-draft POST /purchases/credit-notes/ # Delete purchase credit note (draft only) Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/delete-purchase-credit-note-draft-only DELETE /purchases/credit-notes/{id}/ # Finalize purchase credit note Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/finalize-purchase-credit-note GET /purchases/credit-notes/{id}/finalize/ # List purchase credit notes Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/list-purchase-credit-notes GET /purchases/credit-notes/ # Partial update purchase credit note (draft only) Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/partial-update-purchase-credit-note-draft-only PATCH /purchases/credit-notes/{id}/ # Render purchase credit-note PDF Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/render-purchase-credit-note-pdf GET /purchases/credit-notes/{id}/pdf/ # Retrieve purchase credit note Source: https://docs.piriod.com/api-reference/procurement/purchases/credit-notes/retrieve-purchase-credit-note GET /purchases/credit-notes/{id}/ # Delete purchase (draft only) Source: https://docs.piriod.com/api-reference/procurement/purchases/delete-purchase-draft-only DELETE /purchases/{id}/ # Finalize purchase Source: https://docs.piriod.com/api-reference/procurement/purchases/finalize-purchase GET /purchases/{id}/finalize/ Submits the purchase to the tax agency (when applicable) and locks it. # List purchases Source: https://docs.piriod.com/api-reference/procurement/purchases/list-purchases GET /purchases/ # Partial update purchase (draft only) Source: https://docs.piriod.com/api-reference/procurement/purchases/partial-update-purchase-draft-only PATCH /purchases/{id}/ # Render purchase PDF Source: https://docs.piriod.com/api-reference/procurement/purchases/render-purchase-pdf GET /purchases/{id}/pdf/ # Retrieve purchase Source: https://docs.piriod.com/api-reference/procurement/purchases/retrieve-purchase GET /purchases/{id}/ # Create retention (draft) Source: https://docs.piriod.com/api-reference/procurement/retentions/create-retention-draft POST /retentions/ # Delete retention (draft only) Source: https://docs.piriod.com/api-reference/procurement/retentions/delete-retention-draft-only DELETE /retentions/{id}/ # Finalize retention Source: https://docs.piriod.com/api-reference/procurement/retentions/finalize-retention GET /retentions/{id}/finalize/ # List retentions Source: https://docs.piriod.com/api-reference/procurement/retentions/list-retentions GET /retentions/ # Partial update retention (draft only) Source: https://docs.piriod.com/api-reference/procurement/retentions/partial-update-retention-draft-only PATCH /retentions/{id}/ # Render retention PDF Source: https://docs.piriod.com/api-reference/procurement/retentions/render-retention-pdf GET /retentions/{id}/pdf/ # Retrieve retention Source: https://docs.piriod.com/api-reference/procurement/retentions/retrieve-retention GET /retentions/{id}/ # Create supplier Source: https://docs.piriod.com/api-reference/procurement/suppliers/create-supplier POST /suppliers/ # Delete supplier Source: https://docs.piriod.com/api-reference/procurement/suppliers/delete-supplier DELETE /suppliers/{id}/ # List suppliers Source: https://docs.piriod.com/api-reference/procurement/suppliers/list-suppliers GET /suppliers/ # Partial update supplier Source: https://docs.piriod.com/api-reference/procurement/suppliers/partial-update-supplier PATCH /suppliers/{id}/ # Retrieve supplier Source: https://docs.piriod.com/api-reference/procurement/suppliers/retrieve-supplier GET /suppliers/{id}/ # Julio 2024 Source: https://docs.piriod.com/changelog/2024/julio-2024 ## Previsualización de próxima factura ### Mejora Ahora puedes visualizar cómo será la próxima factura antes de que sea emitida. Esto permite revisar información y validar el resultado del siguiente ciclo de facturación antes de generar el documento final. *** ## Visualización del próximo procesamiento de suscripciones ### Mejora Ahora puedes visualizar la fecha y hora exacta del próximo procesamiento de suscripciones. Esto permite tener mayor visibilidad sobre los próximos intentos de facturación y procesamiento de pagos. *** ## Procesar ahora ### Nueva funcionalidad Se incorporó la opción Procesar ahora para ejecutar manualmente el procesamiento de una suscripción sin esperar el batch automático. La opción permite procesar suscripciones programadas para el día actual o períodos anteriores, facilitando la emisión inmediata de facturas o el procesamiento de pagos. *** ## Planes obligatorios en Signup Forms ### Mejora Ahora puedes definir un plan obligatorio en Signup Forms. Cuando un cliente complete el formulario, el plan configurado aparecerá seleccionado de forma predeterminada y será identificado con la etiqueta Requerido. *** ## Complementos predeterminados en Signup Forms ### Mejora Ahora puedes configurar complementos predeterminados en Signup Forms. Los complementos definidos aparecerán precargados automáticamente al momento de completar el formulario de inscripción. # Septiembre 2024 Source: https://docs.piriod.com/changelog/2024/septiembre-2024 ## Links de Pago ### Nueva funcionalidad Se incorporó soporte para Links de Pago, permitiendo generar enlaces para cobrar pagos de forma rápida y centralizada. Los Links de Pago permiten: * Generar enlaces de pago personalizados. * Definir un monto fijo o permitir que el cliente ingrese el valor a pagar. * Procesar pagos utilizando los procesadores configurados en Piriod. * Generar automáticamente una factura después de un pago exitoso. * Compartir enlaces a través de distintos canales, como sitios web, correo o redes sociales. Consulta la guía de uso para revisar configuración, funcionamiento y opciones disponibles. # Diciembre 2025 Source: https://docs.piriod.com/changelog/2025/diciembre-2025 ## Nueva funcionalidad beta: Documentos de Soporte Se incorporó la primera versión beta de Documentos de Soporte, orientada a centralizar archivos utilizados como respaldo para la emisión de facturas. Consulta más detalles en la sección Funcionalidades Beta. # Enero 2025 Source: https://docs.piriod.com/changelog/2025/enero-2025 ## Ajustes manuales en transferencias ### Mejora Ahora puedes realizar ajustes manuales en transferencias para corregir montos o monedas cuando sea necesario. Esto permite facilitar la conciliación en casos donde el pago recibido no coincide exactamente con la factura original. Los ajustes pueden utilizarse, por ejemplo, para: * Convertir manualmente transferencias recibidas en una moneda distinta a la facturada. * Ajustar diferencias por redondeos, comisiones bancarias o variaciones en el monto recibido. * Corregir montos sin depender de soporte o intervenciones externas. *** ## Configuración de mensajería por cliente ### Mejora Ahora puedes definir qué tipos de correos puede recibir cada cliente directamente desde su configuración. Las opciones disponibles son: * Facturas * Cobranzas * Comprobantes de pago Esto permite controlar el envío automático de correos según la configuración definida para cada cliente. *** ## Pagos parciales y conciliación automática ### Nueva funcionalidad Se incorporó soporte para pagos parciales y nuevos flujos de conciliación automática. Ahora es posible: * Conciliar una factura utilizando múltiples transferencias bancarias. * Registrar pagos parciales mediante transacciones offline. * Combinar transferencias y transacciones offline dentro de un mismo pago. * Conciliar parcialmente transferencias o pagos. * Asociar una transferencia a múltiples facturas. También se incorporó conciliación automática para identificar y asignar transferencias a las facturas correspondientes. Estas mejoras permiten gestionar escenarios de pago más complejos con mayor flexibilidad y menor intervención manual. *** ## Integración con Getnet ### Nueva integración Se incorporó integración con Getnet para procesar pagos en Chile utilizando tarjetas de crédito, débito y prepago. La integración incluye soporte para: ### Getnet Click Permite automatizar cobros recurrentes utilizando tarjetas registradas previamente. ### Getnet Checkout Permite procesar pagos manuales a través del portal de pagos de Piriod o mediante Links de Pago dirigidos a Getnet. Consulta la documentación de integración para revisar configuración, requisitos y funcionamiento de cada modalidad.vvfmvivbfdh # Agosto 2026 Source: https://docs.piriod.com/changelog/2026/agosto-2026 ### Más claridad al procesar una suscripción manualmente **Mejora** Ahora, cuando procesas una suscripción manualmente desde el dashboard, ves de inmediato qué pasó con el cobro y la factura. Si el cobro se rechaza, te mostramos el motivo entregado por el procesador de pagos y te llevamos a la factura impaga cuando existe. Si el cobro se realizó pero la factura no pudo emitirse, te confirmamos que el dinero sí se cobró y que la emisión se reintentará automáticamente. Si el proceso no llegó a generar nada, te explicamos el motivo. La pantalla además se actualiza sola para mostrarte el aviso de "Necesita atención" sin que tengas que recargar. *** ### Exportaciones en segundo plano y un panel para tus descargas **Nuevo** Ahora puedes exportar tus facturas de compra desde el Administrador de compras, algo que antes no era posible: tenías que solicitarlas directamente a nuestro equipo. El proceso corre en segundo plano y te avisamos por correo cuando la exportación esté lista, sin que tengas que quedarte esperando en pantalla. Todas tus exportaciones (las tuyas y las de tu equipo) quedan además en una nueva sección de Descargas, con su estado, quién la generó y cuándo, para que puedas volver a bajarlas las veces que necesites. Los archivos están disponibles por 30 días desde que se generan, pasado ese plazo puedes volver a generarlos desde la misma lista. Si tu exportación en XML incluye documentos que no están disponibles, el archivo indica el motivo en vez de fallar por completo. ### Exporta tus facturas de compra directamente desde la lista **Nuevo** Además, ya no necesitas pasar por la sección de exportaciones: puedes bajar tus facturas de compra directamente desde el Administrador de compras, en la misma pantalla donde las revisas. Selecciona las filas que te interesan, o no selecciones ninguna para exportar todo lo que quedó filtrado en pantalla. Puedes elegir entre la planilla con los datos o, por primera vez, los documentos XML de esas facturas de compra. Si tu búsqueda arroja más de 1.000 registros, te lo indicamos para que ajustes el filtro antes de exportar. # Enero 2026 Source: https://docs.piriod.com/changelog/2026/enero-2026 ## Facturación automática en Links de Pago ### Mejora Ahora los Links de Pago pueden crear automáticamente una factura cuando el pago se completa exitosamente. Al configurar un Link con facturación automática, también se debe definir el tipo de documento que será emitido. ## Nuevo comportamiento El flujo ahora funciona de la siguiente manera: 1. El cliente realiza el pago utilizando el Link. 2. Si el pago es exitoso y el Link tiene facturación automática activa, Piriod crea automáticamente la factura asociada. También se incorporaron mejoras adicionales: * Las facturas creadas con pagos previamente asociados ahora quedan automáticamente marcadas como pagadas al finalizarse. * Se mejoró el control de edición y eliminación de facturas en borrador con pagos relacionados. * Se reforzó el registro de errores en segundo plano para facilitar monitoreo y soporte. *** ## Nuevos modelos de precios ### Nueva funcionalidad Se incorporaron nuevos modelos de precios para permitir configuraciones más flexibles según distintos esquemas de cobro y consumo. Ahora puedes crear planes utilizando: * Precio fijo * Por volumen * Por volumen gradual * Por paquete * Por paquete con excedente También se mejoró la previsualización de planes, permitiendo validar con mayor claridad: * Tramos de cobro * Paquetes y excedentes * Totales estimados según unidades Los planes ahora también pueden configurarse para facturar según consumo utilizando distintos métodos de cálculo: * Suma de registros * Máximo registrado * Último registro del período Los planes existentes continúan funcionando sin cambios y mantienen compatibilidad con la facturación histórica. Consulta la guía completa para revisar ejemplos, configuraciones y casos de uso de cada modelo de precios. # Junio 2026 Source: https://docs.piriod.com/changelog/2026/junio-2026 ### Una página para que tus clientes agreguen o actualicen su tarjeta **Nuevo** Ahora tus clientes cuentan con una página de Checkout propia para registrar una tarjeta nueva o actualizar la que ya tienen guardada. La página muestra la marca de tu negocio y se adapta al procesador de pago: según el caso, tu cliente ingresa los datos de la tarjeta directamente o es redirigido al sitio seguro del procesador para completarlo. Una vez guardada, la tarjeta queda lista para los próximos cobros, y si reemplaza a una anterior, las suscripciones de tu cliente pasan a usarla automáticamente. Cuando a un cliente le falla un cobro automático por un motivo que puede resolver por su cuenta (por ejemplo, tarjeta vencida o sin fondos), ahora le llega un correo con un enlace directo a esta página para que actualice su tarjeta sin que tengas que intervenir. Si el fallo se debe a una causa técnica o ajena al cliente, no se le envía este aviso, para no generarle confusión. También puedes compartir tú mismo el enlace de esta página desde la ficha de tu cliente, ya sea por correo o copiándolo para enviarlo por el canal que prefieras (WhatsApp, chat, etc.). *** ### Código de ítem también en la facturación por lotes **Nuevo** Ahora, al facturar de forma masiva subiendo un archivo, puedes asignarle a cada línea de la factura su propio código y esquema (por ejemplo, un SKU o código interno), agregando las columnas `line_code` y `line_code_scheme` al archivo. Antes esto solo era posible al facturar de forma individual, en la carga masiva había que ajustarlo a mano después. Ambas columnas son opcionales, así que si no las necesitas, puedes seguir facturando exactamente igual que hasta ahora. ### Descarga el archivo original de tus facturaciones masivas **Nuevo** Ahora puedes volver a descargar el archivo con el que iniciaste una facturación masiva, directamente desde el botón "Descargar archivo" en el detalle del proceso. Antes ese archivo quedaba disponible solo al momento de subirlo, sin forma de recuperarlo después desde la plataforma. La descarga está disponible en cualquier etapa del proceso (pendiente, procesando o finalizado), para que puedas revisar o reutilizar los datos cargados cuando lo necesites. *** ### Ajustes en los comprobantes de pago para México **Corrección** Hicimos algunos ajustes en el comprobante de pago (CFDI) para que se genere de forma más compatible con el SAT y sea más simple de completar. El campo "Relación" ahora ofrece solo dos opciones, pago diferido y pago diferido en parcialidades, para evitar incompatibilidades con el SAT. También quitamos el campo "Método de pago", que no corresponde a este tipo de documento. Y si tu cuenta factura en una moneda distinta a MXN, ya no es obligatorio ingresar el tipo de cambio al registrar un comprobante de pago: puedes dejarlo vacío y el comprobante se genera igual (si lo completas, seguimos validando que el valor sea correcto). Para cuentas en pesos mexicanos no hay ningún cambio. ### Consistencia en el tipo de cambio de tus notas de crédito (México) **Corrección** Ahora, cuando emites una nota de crédito en moneda extranjera, siempre se usa el mismo tipo de cambio que la factura que estás anulando (o el tipo de cambio manual que hayas definido en ella, si corresponde). Esto asegura que los montos declarados al SAT sean siempre consistentes entre la factura y su nota de crédito. ### Validación de folio al emitir notas de crédito vía API (México) **Mejora** Si integras con Piriod vía API, ahora al enviar el folio de una nota de crédito de forma explícita, validamos que no haya sido usado antes en otra nota de crédito de tu organización, tanto al crearla o editarla como al finalizarla. Si el folio ya fue utilizado, recibes un error inmediato en vez de que el documento sea rechazado después por el SAT. Esta validación ya existía para facturas, ahora es igual para notas de crédito. *** ### El monto de tus facturas siempre coincide con el del documento fiscal **Corrección** Ahora el monto que ves en Piriod para una factura es siempre el mismo que queda registrado en el documento fiscal emitido. En algunos casos podían presentarse pequeñas diferencias entre lo que mostraba Piriod y lo que finalmente quedaba en el SII, por cómo se calculaban y redondeaban los montos en cada sistema. Ya no debería ocurrir: ahora Piriod usa la misma lógica y precisión que la agencia fiscal para calcular los totales. Si una factura ya estaba correcta, no cambia; solo se ajustan las que presentaban esta diferencia. ### Importa tus XML aunque no uses la facturación incorporada de Piriod **Mejora** Ahora puedes importar tus facturas y notas de crédito en formato XML aunque no tengas conectada la facturación incorporada de Piriod, por ejemplo si facturas con otro proveedor. Antes esta importación requería esa conexión, aunque el proceso solo lee el documento y no necesita ninguna credencial del facturador interno. Si un documento presenta un problema puntual, te lo señalamos como observación en ese documento, sin bloquear el resto de la importación. *** ### Validación más precisa de tus certificados digitales **Mejora** Reforzamos la validación de vigencia de los certificados digitales que usas para emitir tus documentos electrónicos, para que el sistema reconozca con exactitud el momento en que un certificado vence. # Marzo 2026 Source: https://docs.piriod.com/changelog/2026/marzo-2026 ## Auditoría de cambios en suscripciones ### Nueva funcionalidad Se incorporó historial de auditoría en suscripciones para visualizar los cambios realizados a lo largo de su ciclo de vida. La auditoría permite consultar: * Cambios realizados en la suscripción. * Fecha y hora de cada modificación. * Usuario responsable de la acción. * Motivo asociado al cambio cuando corresponda. Esta funcionalidad mejora la trazabilidad operativa y facilita procesos de revisión y auditoría. *** ## Pausa y reactivación de suscripciones ### Nueva funcionalidad Ahora es posible pausar y reactivar suscripciones directamente desde Piriod. Al pausar una suscripción, puedes definir opcionalmente una fecha de reactivación automática. Cuando se alcanza la fecha configurada, la suscripción se reactiva automáticamente y continúa su procesamiento de facturación correspondiente. *** ## Archivado y eliminación de clientes ### Nueva funcionalidad Ahora es posible archivar o eliminar clientes directamente desde Piriod. Los clientes con información asociada, como suscripciones, facturas, pagos o tarjetas, pueden ser archivados para mantener su historial y evitar nuevos usos operativos. Los clientes sin registros asociados pueden eliminarse permanentemente desde la plataforma. *** ## Archivado y eliminación de suscripciones ### Nueva funcionalidad Ahora es posible archivar o eliminar suscripciones directamente desde Piriod. Las suscripciones con información asociada permanecen disponibles como historial mediante archivado, evitando su uso en nuevos procesos operativos. Las suscripciones sin registros asociados pueden eliminarse permanentemente desde la plataforma. *** ## Nuevos campos configurables en comprobantes de pago SAT ### Mejora Se incorporaron nuevos campos configurables en comprobantes de pago SAT para entregar mayor control sobre la información emitida. Ahora es posible definir: * Fecha * Forma de pago * Método de pago * Tipo de cambio para clientes extranjeros con moneda distinta a MXN Esta mejora facilita la emisión de comprobantes ajustados a distintos escenarios operativos y tributarios en México. *** ## Soporte para retenciones ISR en facturas (México) ### Mejora Se incorporó soporte para retenciones ISR en ítems de factura para documentos emitidos en México. Ahora es posible configurar y procesar retenciones asociadas a líneas específicas de la factura, permitiendo una emisión más compatible con requerimientos tributarios del SAT. *** ## Reincorporación de comprobantes de cancelación (México) ### Mejora Se reincorporó soporte para comprobantes de cancelación en documentos emitidos para México, permitiendo mantener compatibilidad con procesos tributarios asociados al SAT. *** ## Soporte para complementos de pago parciales (México) ### Mejora Se incorporó soporte para complementos de pago parciales en documentos emitidos para México. Esta mejora permite registrar y procesar pagos parciales asociados a facturas dentro de los flujos compatibles con el SAT. *** ## Importación de facturas vía correo electrónico ### Nueva integración Se incorporó soporte para importar automáticamente facturas electrónicas recibidas por correo electrónico hacia Piriod. La integración permite procesar documentos XML adjuntos desde cuentas Gmail compatibles e importarlos automáticamente a la plataforma. Esta funcionalidad facilita la integración con proveedores de facturación externos y reduce procesos manuales de carga documental. *** ## Creación automática de clientes en importación XML ### Mejora Se incorporó creación automática de clientes durante la importación de facturas XML DTE. Ahora, cuando el cliente asociado no existe previamente en Piriod, la plataforma puede crearlo automáticamente utilizando la información disponible en el documento importado. También se mejoró la validación y visualización de errores durante el proceso de importación. *** ## Nuevas métricas de ARR ### Mejora Se incorporaron nuevas métricas de ARR (Annual Recurring Revenue) dentro de Reportes. Estas métricas permiten visualizar ingresos recurrentes anualizados y complementar el análisis financiero disponible en Piriod. *** ## Mejoras en sistema de métricas ### Mejora Se realizaron mejoras internas en el sistema de métricas para optimizar procesamiento, consistencia y disponibilidad de información en Reportes y Dashboards. *** ## Mejoras en visualización del botón Pagar en correos de factura ### Corrección Se corrigió la visualización del botón Pagar en correos de facturación y recordatorios. Ahora el botón solo se muestra cuando la cuenta tiene métodos de cobro o información de pago configurada en Piriod, evitando confusión en clientes finales al momento de realizar pagos. # Mayo 2026 Source: https://docs.piriod.com/changelog/2026/mayo-2026 ## Impuestos en documentos genéricos ### Mejora Ahora es posible configurar impuestos en documentos genéricos como Invoice y Recibo. La tasa de impuesto puede definirse al crear la factura o la suscripción, permitiendo calcular automáticamente el total correspondiente. Esta mejora aplica para documentos utilizados en países sin facturación electrónica regulada. Los documentos electrónicos de Chile, México y Brasil continúan utilizando las reglas tributarias definidas por cada tipo de documento. *** ## Corrección de duplicados en intercambio de facturas ### Corrección Se mejoró el procesamiento de facturas electrónicas recibidas mediante intercambio en Chile para evitar la creación de documentos duplicados. Ahora, si una factura ya fue procesada previamente, el sistema la identifica correctamente y evita generar registros repetidos. *** ## Nuevas vistas Pendiente e Historial en Customer Base ### Mejora Se incorporaron nuevas vistas en Customer Base para facilitar la visualización de documentos pendientes e históricos. Ahora las facturas se organizan en dos pestañas: * Pendiente: muestra documentos vencidos o próximos a vencer. * Historial: muestra documentos pagados o anulados. Si el cliente no tiene documentos pendientes, la visualización se mantiene como anteriormente. La funcionalidad se encuentra disponible en español, inglés y portugués. *** ## Mejoras en edición de suscripciones sin medio de pago válido ### Mejora Ahora es posible editar suscripciones aunque la tarjeta asociada ya no se encuentre disponible o haya expirado. También se incorporó la opción de eliminar el medio de pago asociado directamente desde la edición de la suscripción. Además, el sistema ahora evita eliminar tarjetas que estén siendo utilizadas por suscripciones activas, pausadas o que requieran atención. *** ## Corrección en edición de tipos de factura en Signup Forms ### Corrección Se corrigió un problema que impedía editar los tipos de factura configurados en Signup Forms. Ahora es posible modificar tipos de factura, visualizar correctamente las monedas disponibles y guardar cambios sin necesidad de recrear el formulario. *** ## Automatización de solicitudes en Documentos de Soporte ### Mejora Documentos de Soporte incorporó nuevas capacidades para automatizar la gestión de órdenes de compra y HES asociadas a procesos de facturación. Ahora es posible: * Gestionar solicitudes desde una vista Kanban. * Enviar solicitudes directamente desde Piriod. * Configurar solicitudes automáticas por cliente. * Realizar seguimiento automático de estados y vencimientos. Consulta la sección Documentos de Soporte para revisar el funcionamiento completo de la funcionalidad. *** ## Nuevo Dashboard principal ### Mejora Se actualizó el Dashboard principal de Piriod incorporando nuevas vistas y navegación por pestañas para facilitar el acceso a métricas operativas y financieras. El Dashboard ahora organiza la información en las siguientes secciones: * Resumen * Ingresos * Suscripciones * Facturación * Dashboard personalizado El Dashboard personalizado permite configurar métricas utilizando las métricas disponibles en Reportes. Esta actualización mejora la visualización de información clave y permite acceder más fácilmente a métricas específicas según el análisis requerido. > [!TIP] > > La vista personalizada permite configurar métricas utilizando las [métricas disponibles en Reportes](/guia/reportes/coleccion-de-metricas). # Septiembre 2026 Source: https://docs.piriod.com/changelog/2026/septiembre-2026 ### Notificaciones para pagos y tarjetas Ahora tu equipo se entera al instante cuando algo importante pasa con los cobros y las tarjetas de tus clientes, sin tener que entrar a revisar manualmente. ### **Cuando falla un cobro o un cliente actualiza su tarjeta, tu equipo lo sabe.** **Nuevo** \ Antes, si se rechazaba el cobro a una tarjeta guardada, solo tu cliente se enteraba. Ahora tu organización recibe la notificación con el cliente, el monto y el motivo del rechazo. También te avisamos cuando un cliente registra una tarjeta, indicando si es la primera vez o si está reemplazando una anterior (una señal clave para cobranza, porque suele indicar que un cliente moroso acaba de habilitar el cobro). Si un cobro masivo rechaza muchas tarjetas a la vez, recibes un solo aviso agrupado con el total, no cientos de notificaciones. Los correos que reciben tus clientes no cambian. ### **Todas tus notificaciones, en un solo lugar.** **Nuevo** \ El ícono de notificaciones en la barra superior te muestra en tiempo real los avisos de tu organización, con el contador de no leídas actualizado. Al hacer clic en una notificación, vas directo al pago, cliente o proceso que la originó, y puedes marcar todas como leídas de una vez. ### **Cada persona elige qué recibir y cómo.** **Nuevo** \ En Configuración agregamos una pantalla de preferencias de notificaciones: cada miembro del equipo decide qué avisos quiere ver, dentro de la aplicación, por correo, o ambos, o puede silenciarlos todos. La configuración es personal y por organización, así que quien participa en varias empresas puede tener reglas distintas en cada una. ### **Resumen por correo, a tu ritmo.** **Nuevo** \ Si prefieres no depender de entrar a Piriod, ahora puedes recibir un resumen de tus notificaciones por correo, agrupado en lugar de uno por evento (así un cobro masivo con cientos de rechazos llega en un solo correo). Elige la frecuencia que más te acomode: cada 30 minutos, una vez al día, o nunca. *** ### Visibilidad de las solicitudes de tarjeta en tránsito **Nuevo** Cuando le pides a un cliente que registre su tarjeta por correo, ahora puedes seguir esa solicitud hasta que se complete, sin perderle el rastro. Antes, la ficha del cliente solo mostraba las tarjetas ya inscritas: si un cliente aún no completaba el registro, no había forma de saber a quién se lo habías pedido, si seguía esperando su respuesta o si la inscripción había fallado. Ahora la sección "Tarjetas" del detalle del cliente incluye un botón para ver las solicitudes en curso, con la fecha de envío, el procesador de pagos utilizado y un estado que indica si la solicitud espera al cliente, está pendiente de autorización o si falló. Desde ahí también puedes eliminar una solicitud que ya no corresponda. Al enviar una nueva solicitud, el panel se despliega automáticamente para confirmarte que quedó registrada. # Crear complemento de pago Source: https://docs.piriod.com/developers/api-templates/mx-create-payment-complement Emitir **complemento de pago** (SAT México) con Piriod requiere 4 llamadas a la API en la siguiente secuencia: 1. Crear Source 2. Autorizar Payment usando el Source previamente creado 3. Crear Payment Receipt (SAT) 4. Finalizar Payment Receipt (SAT) **1. Crear un Source** En este paso se registra el **origen del pago** en Piriod. El `Source` representa la fuente de pago y contiene la información clave del monto, cliente, método y contexto (en este caso, un `offline_payment` vía transferencia bancaria en MXN). Aquí todavía **no se está autorizando ni asociando el pago a un pago existente**. Solo se está declarando formalmente el instrumento/origen que luego será utilizado para autorizar el pago. Este paso es obligatorio porque el comprobante SAT se genera a partir de un **pago autorizado**, y ese pago debe tener un `source` válido asociado. **Output clave que debes guardar:** * `source.id` → se utilizará en el Paso 2 ```javascript JavaScript theme={null} const createSource = async function () { const payload = { amount: "116000", description: "Prueba", gateway: "offline_payment", offline_payment: { currency: "MXN", date: "2026-02-24", method: "bank_transfer", }, usage: "single", customer: "cus_xxxxxxxxx", }; const source = await piriod.resource.create("sources", payload); // Guarda el ID para el Paso 2 console.log("source.id:", source?.id); return source; }; ``` ```python Python theme={null} import requests def create_source(): url = f"{BASE_URL}/sources/" payload = { "amount": "116000", "description": "Prueba", "gateway": "offline_payment", "offline_payment": { "currency": "MXN", "date": "2026-02-24", "method": "bank_transfer", }, "usage": "single", "customer": "cus_xxxxxxxxx", } resp = requests.post(url, json=payload, headers=headers, timeout=30) resp.raise_for_status() source = resp.json() print("source.id:", source.get("id")) return source # source = create_source() ``` ```shellscript cURL theme={null} curl https://api.piriod.com/sources/ \ -X POST \ -H "Authorization: your-user-api-key" \ -H "X-Simple-Workspace: your-organization-id" \ -H "Content-Type: application/json" \ -d '{ "amount": "116000", "description": "Prueba", "gateway": "offline_payment", "offline_payment": { "currency": "MXN", "date": "2026-02-24", "method": "bank_transfer" }, "usage": "single", "customer": "cus_xxxxxxxxx" }' ``` **2. Autorizar el pago** En este paso se **autoriza el pago existente**, asociándolo al `Source` creado previamente. La autorización indica que el pago fue validado y aceptado dentro del sistema, cambiando su estado (por ejemplo, a `authorized` o equivalente). Sin este paso, el comprobante SAT no puede generarse, ya que únicamente se permite emitirlo sobre pagos autorizados. Este es el momento en que:​ * ​El pago queda formalmente respaldado por un origen de fondos. * ​El sistema valida que el monto y el método sean consistentes. **Inputs necesarios:** * ​`paymentId` * ​`sourceId` **Output clave a validar:** * ​`payment.status` debe reflejar un estado autorizable (ej: `authorized`). ```javascript JavaScript theme={null} const authorizePayment = async function ({ paymentId, sourceId }) { const payload = { source: sourceId, }; const payment = await piriod.resource.create( `payments/${paymentId}`, payload, "authorize" ); console.log("payment.id:", payment?.id); console.log("payment.status:", payment?.status); return payment; }; ``` ```python Python theme={null} import requests def authorize_payment(payment_id: str, source_id: str): url = f"{BASE_URL}/payments/{payment_id}/authorize/" payload = {"source": source_id} resp = requests.post(url, json=payload, headers=headers, timeout=30) resp.raise_for_status() payment = resp.json() print("payment.id:", payment.get("id")) print("payment.status:", payment.get("status")) return payment # payment = authorize_payment(payment_id="pay_lM2nB28b3Nu2yc70LL", source_id="src_xxxxx") ``` ```shellscript cURL theme={null} curl https://api.piriod.com/payments/:payment_id/authorize/ \ -X POST \ -H "Authorization: your-user-api-key" \ -H "X-Simple-Workspace: your-organization-id" \ -H "Content-Type: application/json" \ -d '{ "source": "src_xxxxxxxxx" }' ``` **3. Crear el complemento de pago** En este paso se crea el recurso `payment-receipt`, que representa el **comprobante de pago conforme a SAT México (CFDI de complemento de pago)**. Aquí todavía no se timbra ni se finaliza el comprobante; simplemente se genera el registro inicial que vincula el pago autorizado con el documento fiscal correspondiente. Este paso: * ​Valida que el pago esté autorizado. * ​Prepara la estructura fiscal necesaria para el timbrado. * ​Genera un `receipt.id` que será utilizado en el paso siguiente. **Output clave a guardar:** * ​`receipt.id` * ​`receipt.status` (usualmente en estado preliminar o pendiente) ```javascript JavaScript theme={null} const createPaymentReceipt = async function ({ sourceId }) { const payload = { sources: [sourceId], tax_settings: { mx_payment_form: "03", mx_payment_method: "PUE", mx_relation: "partial_payment_invoice" } }; const receipt = await piriod.resource.create("payment-receipts", payload); // Guarda el ID para el Paso 4 console.log("receipt.id:", receipt?.id); console.log("receipt.status:", receipt?.status); return receipt; ``` ```python Python theme={null} import requests def create_payment_receipt(source_id: str): url = f"{BASE_URL}/payment-receipts/" payload = { "sources": [source_id], "tax_settings": { "mx_payment_form": "03", "mx_payment_method": "PUE", "mx_relation": "partial_payment_invoice" } } resp = requests.post(url, json=payload, headers=headers, timeout=30) resp.raise_for_status() receipt = resp.json() print("receipt.id:", receipt.get("id")) print("receipt.status:", receipt.get("status")) return receipt # receipt = create_payment_receipt(payment_id="pay_lM2nB28b3Nu2yc70LL") ``` ```shellscript cURL theme={null} curl https://api.piriod.com/payment-receipts/ \ -X POST \ -H "Authorization: your-user-api-key" \ -H "X-Simple-Workspace: your-organization-id" \ -H "Content-Type: application/json" \ -d '{ "sources": [sou_xxxxxxxxxxxxxx], "tax_settings": { "mx_payment_form": "03", "mx_payment_method": "PUE", "mx_relation": "partial_payment_invoice" } }' ``` **4. Finalizar el complemento de pago** ​Este paso ejecuta el proceso de **finalización y timbrado fiscal** del comprobante ante el SAT.​ Al finalizar: * ​El comprobante se valida fiscalmente. * ​Se genera el XML timbrado. * ​Se habilita el PDF (si aplica). * ​El estado cambia a finalizado (`finalized`, `issued` o similar). Este paso es el que convierte el registro preliminar en un documento fiscal válido ante el SAT. Después de esta operación, el comprobante: * ​No debería modificarse. * ​Puede ser descargado o enviado al cliente. * ​Queda registrado oficialmente como CFDI de complemento de pago. **Output esperado:** * ​`receipt.status` final. * ​`xml_url` y/o `pdf_url` (si el API los expone). ```javascript JavaScript theme={null} const finalizePaymentReceipt = async function ({ receiptId }) { const finalized = await piriod.resource.get( "payment-receipts", receiptId, "finalize" ); console.log("finalized.id:", finalized?.id); console.log("finalized.status:", finalized?.status); return finalized; }; ``` ```python Python theme={null} import requests def finalize_payment_receipt(receipt_id: str): url = f"{BASE_URL}/payment-receipts/{receipt_id}/finalize/" resp = requests.get(url, headers=headers, timeout=30) resp.raise_for_status() finalized = resp.json() print("finalized.id:", finalized.get("id")) print("finalized.status:", finalized.get("status")) return finalized # finalized = finalize_payment_receipt(receipt_id="prc_xxxxx") ``` ```shellscript cURL theme={null} curl https://api.piriod.com/payment-receipts/:payment_receipt_id/finalize/ \ -X GET \ -H "Authorization: your-user-api-key" \ -H "X-Simple-Workspace: your-organization-id" \ ``` # Overview Source: https://docs.piriod.com/developers/api-templates/overview foo # Recursos para desarrolladores Source: https://docs.piriod.com/developers/overview > Aprende a usar SDK, claves de API y herramientas de integración. ## Comenzar Usa las referencias de Piriod para crear y administrar tu integración. > **[API Reference](/api-reference/introduction)** ## **Herramientas** > **[Webhooks](/developers/api-templates/overview)** > **[API Templates](/developers/webhooks/overview)** # Crear un webhook Source: https://docs.piriod.com/developers/webhooks/crear-un-webhook Conoce cómo escribir el código para manejar las notificaciones al webhook. Para agregar webhooks a tu integración debes crear un endpoint para exponerlo en internet a través de una URL (por ejemplo, [https://myproduct.com/webhooks](https://myproduct.com/webhooks)). Crear un endpoint de webhook en tu servidor no es tan diferente a crear cualquier página en su sitio web o aplicación. Puede estar escrito en Ruby, PHP, NodeJS, Python usando o no un framework de Python como Flask. ## Consideraciones En cada activación de un evento, Piriod envía los datos del webhook a su endpoint en formato JSON. * `event` - corresponde al [nombre del evento](https://docs.piriod.com/guide/desarrolladores/webhooks#eventos). * `object_id` - corresponde al id del objeto que activó el evento. Por lo tanto, como mínimo, el endpoint del webhook debe esperar datos a través de una solicitud POST y confirmar la recepción exitosa de esos datos. ## Respuesta HTTP y desactivación automática Tu endpoint debe devolver un código de estado HTTP 2xx a Piriod. Cualquier respuesta fuera de este rango, incluidos los códigos 3xx, indica a Piriod que el evento no se recibió correctamente. > [!WARNING] > > Si endpoint devuelve un código de estado distinto de 2xx en **3 llamadas consecutivas**, el webhook se desactiva automáticamente. Deberás volver a activarlo manualmente desde el dashboard de Piriod. Dado que la entrega exitosa es fundamental, su punto final debe devolver una respuesta 2xx antes de ejecutar cualquier lógica de negocio compleja que pueda causar un error o exceder el tiempo de espera de 6 segundos. ## Example code El siguiente ejemplo muestra un endpoint de Python/Flask que confirma la recepción y luego obtiene el objeto Payment completo de la API de Piriod. ```python theme={null} import requests from flask import Flask app = Flask(__name__) PIRIOD_API = 'https://api.piriod.com' credentials = { 'Authorization': f'Token {your_piriod_token}', 'x-simple-workspace': 'your_piriod_organization_id' } @app.route('/webhooks', methods=['POST']) def webhooks(): payload = request.json if not payload: abort(400) if payload.get('event') == 'payment.created': payment = _get_payment(payload.get('id')) # do anything with your new payment return True def _get_payment(id): r = requests.get(f'{PIRIOD_API}/payments/{id}/', headers=credentials) if not r.status_code == requests.codes.ok: abort(r.status_code) return r.json() if __name__ == '__main__': app.run(debug=True) ``` Una vez que tu endpoint esté listo y sea accesible públicamente, el siguiente paso es registrarlo en Piriod. # Recibe notificaciones de eventos en tiempo real con webhooks Source: https://docs.piriod.com/developers/webhooks/overview Los webhooks de Piriod notifican a tu servicio cuando cambian los clientes, las facturas, los pagos o las suscripciones. Configura un endpoint y regístralo en dos pasos. Piriod utiliza webhooks para notificar a tu aplicación cuando se activa un evento específico en tu cuenta. Imagina un endpoint de webhook como un número de teléfono al que Piriod llama para informar sobre sucesos en tiempo real: un nuevo cliente, un pago completado o un cambio de suscripción. Tu endpoint es el código que responde a la llamada y actúa en función de la información recibida. Técnicamente, un endpoint de webhook es un código alojado en tu servidor y expuesto en una URL pública (por ejemplo, [https://myproduct.com/webhooks](https://myproduct.com/webhooks)). Puede estar escrito en Python, PHP, Node.js, Ruby o cualquier otro lenguaje. Cuando se activa un evento, Piriod envía una solicitud POST a tu endpoint con una payload JSON que contiene el nombre del evento y el ID del objeto que lo activó. Tu endpoint utiliza esa información para ejecutar la lógica de negocio correspondiente; por ejemplo, otorgar acceso a un usuario después de un pago exitoso. ## Cuándo usar webhooks Utiliza webhooks cuando tu aplicación necesite actuar tan pronto como ocurra algo en organización de Piriod. Algunos casos de uso comunes incluyen: * Nueva suscripción - otorgar acceso a un usuario en su sistema en el momento en que se crea una suscripción. * Pago fallido - revocar el acceso a su producto o notificar al usuario inmediatamente cuando falle un pago. > [!NOTE] > > Las notificaciones de webhook se entregan de forma asíncrona y no se recomiendan para aplicaciones críticas en cuanto al tiempo. Cuando el tiempo es crucial, utilice la API de Piriod para obtener los eventos directamente. ## Configuración en dos pasos Configurar webhooks requiere dos pasos: 1. [Crear un webhook](/guide/desarrolladores/webhooks/crear-un-webhook) en tu servicio. 2. [Registrar un webhook](/guide/desarrolladores/webhooks/registrar-un-webhook) en tu organización de Piriod. ## Eventos disponibles La tabla que aparece a continuación enumera todos los eventos que Piriod puede enviar a tu endpoint. | Event name | Description | | - | - | | `customer.created` | Se activa cuando se crea un cliente. | | `customer.updated` | Triggered when a customer is updated. | | `invoice.created` | Triggered when an invoice is created. | | `invoice.finalized` | Triggered when an invoice is finalized (submitted to the tax authority). | | `invoice.paid` | Triggered when an invoice is paid. | | `invoice.updated` | Triggered when an invoice is updated. | | `payment.created` | Triggered when a payment is created. | | `payment.succeeded` | Triggered when a payment succeeds. | | `payment.updated` | Triggered when a payment is updated. | | `source.created` | Triggered when a payment source is created. | | `source.stored` | Triggered when a payment source (credit/debit card) is successfully stored. | | `source.updated` | Triggered when a payment source is updated. | | `subscription.created` | Triggered when a subscription is created. | | `subscription.updated` | Triggered when a subscription is updated. | # Registrar un webhook Source: https://docs.piriod.com/developers/webhooks/registrar-un-webhook Registra la URL del endpoint de tu servicio en Piriod, selecciona los eventos a los que deseas suscribirlo y gestiona su activación, desactivación o eliminación desde el dashboard. Tras crear el endpoint del webhook en tu servicio, debes registrarlo en Piriod para que la plataforma sepa dónde enviar las notificaciones de eventos. El registro solo tarda unos segundos desde el dashboard de Piriod. ## Agrega el endpoint del webhook en tu organización **1. Abrir configuración de Webhooks** En tu dashboard de Piriod, ve a **Configuración de la organización → Webhooks**. **2. Crear un nuevo webhook** Click **+ Nuevo webhook** para abrir la configuración de registro. **3. Rellena los detalles** Complete los siguientes campos: * **URL** - ingresa la URL de tu endpoint. Debes usar HTTPS. * **Descripción** - texto opcional para identificar este endpoint. * **Eventos** - selecciona los eventos que deseas que activen este webhook. **4. Guardar** Haz clic en **Crear webhook** para finalizar el registro. Piriod comenzará a enviar eventos coincidentes a tu endpoint inmediatamente. ## Administrar el webhook Desde la vista de detalles del webhook puedes: * **Deshabilitar** - pausar la entrega de mensajes sin eliminar el endpoint. No se envían eventos mientras esté deshabilitado. * **Habilitar** - reanudar la entrega después de la desactivación. * **Eliminar** - eliminar permanentemente el endpoint. > [!NOTE] > > Si tu endpoint devuelve respuestas distintas de 2xx **tres veces seguidas**, Piriod lo desactiva automáticamente. Vuelve a activarlo desde esta misma vista de detalles una vez que se haya resuelto el problema. # Verificar firma Source: https://docs.piriod.com/developers/webhooks/verificar-firma Confirms que las solicitudes de webhook son auténticas calculando una firma HMAC-SHA256 con tu secreto de endpoint y comparándola con el encabezado x-piriod-signature. Piriod firma cada solicitud de webhook que envía, lo que permite confirmar que la solicitud es auténtica y no ha sido falsificada por un tercero. La verificación es opcional, pero se recomienda encarecidamente para los endpoints de producción. ## Obtén tu secreto de webhook Cada webhook registrado tiene su propio secreto único. **1. Abre tu webhook** Ve a **Configuración de la organización → Webhooks** y haz clic en el webhook que deseas verificar. **2. Copia el secreto** Busca la sección **Secreto** y haz clic en **Copiar secreto**. Guarda este valor de forma segura en tu servidor; nunca lo expongas en el código del cliente. > [!NOTE] > > Cada webhook tiene una clave secreta diferente. Si utilizas varios webhooks, recupera y almacena una clave secreta para cada uno por separado. ## Verificar la firma Piriod incluye la firma en el encabezado HTTP `x-piriod-signature` de cada solicitud. Para verificarla, calcula un HMAC-SHA256 sobre los valores del payload de forma concatenada utilizando tu secreto de webhook y, a continuación, compara el resultado con el valor del encabezado. ```python theme={null} import hashlib import hmac from flask import Flask, request, abort app = Flask(__name__) WH_SECRET = 'whsecret_g9En7rfNBZBYFr968pLqPDQ6O302Q1DAI3TXi3aky1eAcUqgJg3EjBP' @app.route('/webhooks', methods=['POST']) def webhooks(): payload = request.json piriod_signature = request.headers.get('x-piriod-signature') if not _signature_is_valid(payload, piriod_signature): abort(400) if not payload: abort(400) if payload.get('event') == 'payment.created': # handle the payment.created event pass return '', 200 def _signature_is_valid(payload, piriod_signature): signature = hmac.new( WH_SECRET.encode(), msg=(''.join(map(str, payload.values()))).encode('UTF-8'), digestmod=hashlib.sha256 ).hexdigest() return signature == piriod_signature if __name__ == '__main__': app.run(debug=True) ``` > [!WARNING] > > Si la verificación de la firma falla, devuelve un código de estado `400` y no proceses el evento. Esto protege tu aplicación de solicitudes falsificadas. # Documentos de soporte (Beta) Source: https://docs.piriod.com/funciones beta/documentos-de-soporte Documentos de Soporte permite gestionar archivos y procesos asociados a órdenes de compra (OC), HES y otros documentos utilizados como respaldo en procesos de facturación B2B. La funcionalidad busca centralizar el seguimiento operativo previo a la emisión de facturas y reducir dependencias manuales en la gestión de documentación requerida por clientes corporativos. Actualmente esta funcionalidad se encuentra en etapa beta y continuará incorporando nuevas capacidades en próximas iteraciones. ## Funcionalidades disponibles ### Gestión de documentos Actualmente puedes: * Importar documentos de soporte en formato PDF. * Registrar información asociada al documento, como fechas, cliente y tipo de documento. * Centralizar documentos relevantes directamente en Piriod. El módulo también entrega indicadores operativos para identificar: * Documentos próximos a vencer. * Documentos vencidos. * Documentos cargados que aún no están siendo utilizados. ### Solicitudes de documentos Ahora es posible crear solicitudes de órdenes de compra y HES directamente desde Piriod. Las solicitudes permiten: * Definir destinatarios. * Asociar suscripciones relacionadas. * Configurar fechas límite. * Centralizar el seguimiento de solicitudes desde la plataforma. ### Automatización y seguimiento Documentos de Soporte incorpora automatizaciones para facilitar el seguimiento operativo de documentación requerida antes de facturar. Actualmente es posible: * Configurar solicitudes automáticas por cliente. * Detectar cobros próximos sin documentos asociados. * Enviar solicitudes automáticas según reglas configuradas. * Realizar seguimiento automático de vencimientos y estados. La funcionalidad también incorpora una vista Kanban para visualizar el estado de solicitudes y documentos dentro de un mismo flujo operativo. ## Integración con facturación Los documentos asociados pueden ser utilizados como referencia al momento de emitir facturas, manteniendo continuidad con los procesos de facturación ya configurados en Piriod. ## Próximas iteraciones Las próximas iteraciones consideran automatizaciones adicionales para facilitar la recepción y carga de documentos directamente en la plataforma. ## Sobre esta funcionalidad Documentos de Soporte continuará evolucionando de forma progresiva en base a procesos reales de facturación B2B y flujos operativos de clientes corporativos. # Introducción a funciones beta Source: https://docs.piriod.com/funciones beta/introduccion-a-funciones-beta # Funcionalidades Beta En esta sección encontrarás funcionalidades que actualmente se encuentran en etapa beta dentro de Piriod. Estas funcionalidades están en evolución y pueden incorporar nuevas capacidades, ajustes operativos o cambios en su comportamiento a medida que avanzan sus próximas entregas. El objetivo de esta etapa es validar procesos reales junto a clientes, mejorar la experiencia operativa y evolucionar cada módulo de forma progresiva. Aquí podrás revisar: * Qué funcionalidades están disponibles actualmente. * Qué capacidades se encuentran en desarrollo. * Qué cambios o mejoras serán incorporados próximamente. # Flujos De Trabajo Source: https://docs.piriod.com/guia/comenzar/flujos-de-trabajo ## Flujos de trabajo Los procesos de facturación y cobro pueden variar según el modelo de negocio. Piriod es flexible para adaptarse a distintas formas de operar — desde flujos completamente automatizados hasta procesos manuales. Explora los flujos disponibles y elige el que mejor se ajusta a tu operación. *** ### Suscripción → Facturación → Pago → Cargo automático El flujo estándar del modelo SaaS. El cliente se suscribe, registra su tarjeta y los procesos de facturación y cobro se ejecutan automáticamente en cada ciclo. **Beneficios** * Mínima supervisión * Baja tasa de facturas impagas * El cliente se suscribe de forma autónoma * Cargo automático a la tarjeta **Dificultades** * Obliga a estandarizar los planes de precios (puede convertirse en un beneficio) *** ### Suscripción → Facturación → Pago Similar al anterior, pero el cliente debe realizar el pago manualmente cada vez que recibe una factura periódica. **Beneficios** * El cliente se suscribe de forma autónoma **Dificultades** * Requiere supervisar el cumplimiento del pago * El cliente debe pagar manualmente en cada ciclo * Obliga a estandarizar los planes de precios (puede convertirse en un beneficio) *** ### Facturación → Pago → Cargo Flujo tradicional donde la organización emite la factura y realiza el cargo a la tarjeta del cliente de forma manual. **Beneficios** * Precio de los ítems totalmente flexible * Baja tasa de facturas impagas * La organización controla el momento del cargo **Dificultades** * Poca escalabilidad — el proceso se vuelve insostenible a mayor volumen de clientes *** ### Facturación → Pago Similar al anterior, pero el pago lo realiza el cliente cada vez que recibe una factura. **Beneficios** * Precio de los ítems totalmente flexible **Dificultades** * Poca escalabilidad — el proceso se vuelve insostenible a mayor volumen de clientes * Requiere supervisar el cumplimiento del pago * El cliente debe pagar manualmente en cada ciclo *** ### Pago → Cargo Flujo simplificado que elimina la emisión de facturas. El cobro se realiza directamente a la tarjeta del cliente. Su viabilidad depende de la normativa fiscal del país donde opera el negocio. **Beneficios** * Monto a cobrar totalmente flexible * La organización controla el momento del cargo **Dificultades** * En la mayoría de los casos no cumple con la obligación de emitir factura o recibo * Poca escalabilidad — el proceso se vuelve insostenible a mayor volumen de clientes *** ### Pago El cliente realiza el pago cada vez que recibe un enlace de cobro enviado por la organización. No se emite factura. **Beneficios** * Monto a cobrar totalmente flexible **Dificultades** * Poca escalabilidad — el proceso se vuelve insostenible a mayor volumen de clientes * Requiere supervisar el cumplimiento del pago * El cliente debe pagar manualmente en cada ciclo # Introducción a Piriod Source: https://docs.piriod.com/guia/comenzar/introduccion-a-piriod Piriod es una plataforma que automatiza la gestión de suscripciones, facturación y pagos recurrentes. Permite administrar todo el ciclo de ingresos de tu negocio — desde la creación de clientes y suscripciones, hasta la emisión de documentos y la cobranza. Con Piriod puedes: * Crear y gestionar suscripciones recurrentes * Configurar distintos modelos de cobro (fijo, por volumen, por uso, entre otros) * Emitir documentos automáticamente * Procesar pagos y hacer seguimiento de la cobranza * Centralizar toda la operación en un solo lugar Esta guía te ayudará a configurar Piriod y entender cómo usar cada módulo paso a paso. *** ## **Módulos principales** Piriod está organizado en distintos módulos, cada uno enfocado en una parte del proceso de cobro y gestión de suscripciones. *** | Módulo | Descripción | | :- | :- | | **Suscripciones** | Gestión de productos, planes y cobros recurrentes | | **Facturación** | Emisión y seguimiento de documentos | | **Ingresos** | Gestión de pagos y cuentas por cobrar | | **Contactos** | Gestión de clientes, personas y unidades organizativas | | **Componentes** | Formularios de suscripción, portal de autogestión y links de pago | | **Reportes** | Organización y personalización de métricas | | **Integraciones** | Procesadores de facturación, pago y otras integraciones disponibles | *** ## **Primeros pasos** Sigue estos pasos para comenzar a usar Piriod: 1. **Conectar un procesador de pago** — ve a **Integraciones → Procesadores de pago** y conecta uno de los proveedores disponibles para comenzar a recibir pagos. 2. **Configurar facturación** — si operas en un país con facturación electrónica, ve a **Integraciones → Procesadores de facturación** y configura la integración correspondiente. 3. **Crear un cliente** — ve a **Contactos → Clientes → Nuevo** e ingresa la información del cliente. 4. **Crear un producto y plan** — ve a **Suscripciones → Productos → Nuevo** y define el producto, su plan de precios y frecuencia de facturación. 5. **Crear una suscripción** — ve a **Suscripciones → Facturas recurrentes → Nuevo**, selecciona el cliente, el plan y la fecha de inicio. Piriod se encargará automáticamente del resto. *** # Customer Base Source: https://docs.piriod.com/guia/componentes/customer-base Customer Base es un portal de autoservicio que puedes integrar en tu sitio web o aplicación para que tus clientes administren su propia suscripción y facturación — sin que tengas que desarrollarlo tú mismo. Con Customer Base, tus clientes pueden: * Administrar su información de facturación * Ver el resumen y estado de su suscripción * Administrar su tarjeta de pago * Cancelar su suscripción * Ver su historial de facturas pagadas, vencidas y por vencer ![Captura De Pantalla 2026 04 30 A La(s) 19 08 33](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.08.33.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=2ee56f278e6bb1d848140e0085249574) *** ## Configuración Ve a **Componentes → Customer Base → Nuevo portal de cliente**. ### Funcionalidades Activa o desactiva las capacidades que quieres habilitar para tus clientes: * **Administrar información de facturación** * **Cancelar suscripción** * **Administrar tarjeta** * **Visualizar facturación y pagos** ### Método de autenticación Define cómo se autenticarán tus clientes al acceder al portal: **Autenticación con email a través de Piriod** — Piriod gestiona el login enviando un enlace de acceso al email del cliente. No requiere desarrollo adicional. **Integrar con una autenticación existente** — usa tu propio sistema de autenticación. Requiere implementar la creación de sesiones vía API (ver sección de instalación más abajo). ### Redireccionamiento por defecto URL a la que se redirige al cliente cuando su sesión expira. Una vez configurado, haz clic en **Crear y poner en vivo**. ![Captura De Pantalla 2026 04 30 A La(s) 19 08 54](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.08.54.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=a7ecc3a8a1568320bad31f54494112be) *** ## Instalación #### 1. Agregar el tag HTML Agrega este elemento en los lugares de tu sitio donde quieres que aparezca el portal: ```html theme={null}
``` #### 2. Agregar el fragmento de JavaScript Pega este script antes del cierre de `` en las páginas donde quieres que Customer Base aparezca: ```html theme={null} ``` #### 3. Crear una sesión para tu cliente Si usas autenticación existente, debes crear una sesión desde tu servidor para cada cliente. La sesión protege la información del cliente y permite autenticarlo con el método que prefieras. Para crear una sesión necesitas el ID del cliente y una `return_url`. Ejemplo en Python: ```python theme={null} import requests url = 'https://api.piriod.com/customer_base/sessions/' headers = { 'Authorization': f'Token {api_key}', 'x-simple-workspace': '{organization_id}' } payload = { 'base': 'bas_aiFqLDu2cUmDpWQjV1', 'customer': 'cus_18NSMz56sIVMsXo6Fy', 'return_url': 'https://dashboard.myproduct.com/', } r = requests.post(url=url, json=payload, headers=headers) ``` La respuesta incluye un atributo `key`. Devuelve ese valor al cliente y pásalo a través de `window.piriodSettings`: ```html theme={null} ``` Consulta la referencia completa en [Create a session](https://docs.piriod.com/api/applications/customer-base/sessions#create-a-session). *** ### Opciones de personalización Usa `piriodSettings.options` para personalizar la apariencia del portal. ```html theme={null} ``` #### `options.locale` Define el idioma del portal. | Valor | Descripción | | :- | :- | | `es_MX` (default) | Español de México | | `en_US` | Inglés | | `po_BR` | Portugués de Brasil | #### `options.backgroundColor` Define el color de fondo del portal. Acepta nombres de color CSS, hex o RGB. | Formato | Ejemplo | | :- | :- | | Literal (default: `white`) | `black` | | Hexadecimal | `#F8F8F8` | | RGB | `rgb(248, 248, 248)` | # Links Source: https://docs.piriod.com/guia/componentes/links Links te permite crear enlaces de pago personalizados en segundos y comenzar a recibir pagos sin integraciones complejas. Puedes compartir el mismo enlace con múltiples clientes a través de cualquier canal — sitio web, redes sociales, email o código QR. *** ## Crear un link de pago Ve a **Componentes → Links → Nuevo link de pago**. El formulario se divide en tres pasos. En el lado derecho verás una vista previa en tiempo real de cómo quedará la página de pago. #### Paso 1 — Precio ![Captura De Pantalla 2026 04 30 A La(s) 19 32 41](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.32.41.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=5834e9a5549a28d9a6317b884fc3956d) * **Moneda** — define la moneda del cobro * **Tipo de precio** * **Precio fijo** — defines el monto * **El cliente elige cuánto pagar** — puedes sugerir un monto y opcionalmente definir un mínimo y máximo * **Monto** — visible solo si seleccionaste precio fijo #### Paso 2 — Más opciones ![Captura De Pantalla 2026 04 30 A La(s) 19 32 48](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.32.48.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=30e73e7a2a63bb34a40feb275fb495e2) * **Descripción** — texto visible para el cliente en la página de pago * **Tipo de consumidor** — Empresa, Persona o ambos * **Llamado a la acción** — define el texto del botón: Pagar, Donar o Reserva #### Paso 3 — Después del pago ![Captura De Pantalla 2026 04 30 A La(s) 19 32 56](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.32.56.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=4d2036fb25b8e6bab8539abcced412b0) Define qué verá el cliente una vez completado el pago: * **Mostrar un mensaje de confirmación** — personaliza el texto que aparece al finalizar * **Redireccionar a mi sitio web** — envía al cliente a una URL específica * **Crear una factura posterior al pago** — activa esta opción para emitir un documento automáticamente Haz clic en **Crear enlace**. > [!NOTE] > > Los métodos de pago disponibles dependen de los procesadores conectados en tu cuenta de Piriod. *** ### Compartir el link Una vez creado el link, desde la sección **Compartir** puedes: ![Captura De Pantalla 2026 04 30 A La(s) 19 33 48](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-19.33.48.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=7ade2a4446804c0ac701b65b325493ca) * **Copiar el enlace** — compártelo directamente con tus clientes o publícalo donde quieras * **Código QR** — genera y descarga un QR para compartir de forma digital o presencial. Útil para cobros en persona, reservas, eventos o donaciones * **Layout** — elige entre disposición vertical u horizontal para la página de pago * **Contenido de la página** — personaliza el título y descripción que verá el cliente * **Navegación** — agrega ítems al menú con enlaces a tus redes sociales, sitio web u otros * **Vínculos** — agrega enlaces a términos de uso y políticas de privacidad si corresponde * **Modo de prueba** — actívalo para probar el flujo sin procesar pagos reales *** ## Instalación low-code Incrusta el link directamente en tu sitio o aplicación. Copia el fragmento desde **Compartir → Con código** y pégalo antes del cierre de ``. ```html theme={null}
``` Si usas React, Vue u otro framework, inyecta el script de la forma convencional de cada uno. # Signup Forms Source: https://docs.piriod.com/guia/componentes/signup-forms Signup Forms es el formulario de suscripción de tu negocio. Tus clientes pueden elegir un plan, ingresar sus datos de facturación y configurar su método de pago — todo en un flujo guiado de tres pasos. Puedes instalarlo como una página alojada (sin código) o incrustarlo directamente en tu sitio o aplicación (low-code). [YouTube video player](https://www.youtube.com/embed/vALMPry8YFM) *** ## Crear un Signup Form Ve a **Componentes → Signup Forms → Nuevo**. Asigna un nombre al formulario para identificarlo internamente y configura cada sección: *** ### Paso 1 — Productos Define qué planes y complementos estarán disponibles para el cliente. ![Captura De Pantalla 2026 04 30 A La(s) 18 57 37](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-18.57.37.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=060fa004744a451332fa59105f56ceca) **Planes** 1. Haz clic en **Agregar plan** y selecciona un producto y plan de tu lista 2. Agrega el nombre y descripción que verá tu cliente 3. Opcionalmente define una cantidad mínima **Complementos** 1. Haz clic en **Agregar complemento** y selecciona uno de tu lista 2. Agrega nombre y descripción para el cliente 3. Opcionalmente define una cantidad mínima **Otras opciones** * **Permitir selección de múltiples planes** — activa esta opción si quieres que el cliente pueda suscribirse a más de un plan a la vez > Si aún no tienes productos o planes creados, revisa las guías de Productos y Planes. Haz clic en **Continuar** para avanzar al siguiente paso. *** ### Paso 2 — Facturación Configura cómo se capturarán los datos de facturación del cliente. ![Captura De Pantalla 2026 04 30 A La(s) 18 57 46](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-18.57.46.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=ec0e128ed79534dc151ba739ba6da183) * **Tipo de consumidor** — define si el formulario acepta empresas, personas naturales o ambos * **Cobertura** — selecciona los países donde estarán disponibles tus planes * **Tipos de factura** — selecciona los tipos de documento que el cliente podrá elegir al completar sus datos * **Etiquetas personalizadas** — personaliza los nombres de los campos Nombre, Estado e ID Fiscal que verá el cliente en el formulario Haz clic en **Continuar**. *** ### Paso 3 — Pago Configura el método de pago y las opciones avanzadas del formulario. ![Captura De Pantalla 2026 04 30 A La(s) 18 57 54](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-18.57.54.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=f14dbcd22768f492d655144247d3e4cf) * **Solicitar inscripción de tarjeta** — activa esta opción si quieres que el cliente registre una tarjeta al suscribirse. Si está desactivada, el cliente recibirá la factura con un link al portal de pagos #### **Opciones avanzadas** * **Redireccionamiento por defecto** — URL a la que se redirige al cliente después de completar la suscripción * **Webhook URL** — URL para notificar a tu sistema cuando ocurre una suscripción exitosa * **Procesamiento instantáneo** *(Beta)* — procesa la suscripción de inmediato al completar el formulario * **Mantener información en caché** *(Beta)* — conserva los datos del cliente entre sesiones Haz clic en **Crear y poner en vivo** para publicar el formulario. *** ## Instalación no-code — Página alojada La opción más rápida. Piriod genera una página lista para compartir sin necesidad de modificar tu sitio. 1. Ve al formulario creado y haz clic en **Instalación → Página alojada** 2. Personaliza el layout y los encabezados de la página 3. Haz clic en **Guardar** 4. Usa **Ir a la página alojada** para ver y compartir el link > Activa o desactiva el **Modo de prueba** desde la parte superior del formulario antes de publicar. *** ## Instalación low-code — Incrustado en tu sitio Incrusta el formulario directamente en tu aplicación o sitio web. Recomendado para negocios SaaS o que necesitan mayor flexibilidad en su flujo de cobro. Copia el fragmento desde **Instalación → Fragmento de JavaScript** y pégalo antes del cierre de `` en las páginas donde quieres que aparezca el formulario. ```html theme={null}
``` Si usas React, Vue u otro framework, inyecta el script de la forma convencional de cada framework. *** ### Opciones de personalización Usa `piriodSettings.options` para personalizar el comportamiento del formulario. #### `options.backgroundColor` Aplica un color de fondo al formulario. Acepta nombres de color CSS, hex o rgba. ```javascript theme={null} window.piriodSettings = { service: "signupForms", publishableKey: "YOUR SIGNUP FORM PUBLISHABLE KEY", options: { backgroundColor: "white" } }; ``` Valor por defecto: `transparent` #### `options.selectedPlans` Inicializa el formulario con planes preseleccionados. Requiere que el campo **ID personalizado** esté definido en la configuración del plan. ```javascript theme={null} window.piriodSettings = { service: "signupForms", publishableKey: "YOUR SIGNUP FORM PUBLISHABLE KEY", options: { selectedPlans: [ { custom_id: "MY_CUSTOM_ID", quantity: 3 } ] } }; ``` *** ### Información de contexto Usa `piriodSettings.context` para pre-completar campos del formulario cuando ya tienes datos del usuario. #### `context.customer` Pre-completa los datos de facturación. Campos disponibles: `address`, `country`, `email`, `name`, `tax_id`. ```javascript theme={null} window.piriodSettings = { service: "signupForms", publishableKey: "YOUR SIGNUP FORM PUBLISHABLE KEY", context: { customer: { country: "US", email: "user@email.com", tax_id: "11111111-1" } } }; ``` #### `context.metadata` Añade metadatos a la suscripción generada por el formulario. ```javascript theme={null} window.piriodSettings = { service: "signupForms", publishableKey: "YOUR SIGNUP FORM PUBLISHABLE KEY", context: { metadata: { userID: "123456", foo: "foo" } } }; ``` *** ### Eventos de JavaScript #### `piriod_signup_form_subscription` Se emite cuando el proceso de suscripción finaliza. Devuelve `status` con valor `succeeded` o `failed`. ```javascript theme={null} window.addEventListener('message', function(e) { if (e.data.event === 'piriod_signup_form_subscription' && e.origin === 'https://js.piriod.com') { if (e.data.status === 'succeeded') { console.log('subscription created successfully'); } else { console.log('subscription creation failed'); } } }); ``` # Banco Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/banco Conecta tu cuenta bancaria para que Piriod detecte automáticamente las transferencias recibidas y las asocie a los pagos de tus clientes. La conexión se realiza a través de **Fintoc**. > Esta funcionalidad requiere una **cuenta empresa**. Si tienes una cuenta personal, solicita el cambio a tu ejecutivo bancario antes de continuar. Ve a **Configuración de la organización → Banco**. *** ### Conectar tu banco 1. Haz clic en **Conectar banco** 2. En el cuadro de Fintoc, haz clic en **Continuar** 3. Selecciona tu banco — los disponibles son: * Banco Estado * Banco de Chile * Santander * BCI * BCI - 360 Connect * Banco BICE * Itaú * Scotiabank * Banco Security 4. Ingresa tu RUT personal, RUT empresa y contraseña de tu cuenta bancaria Una vez conectado, Piriod mostrará los movimientos recibidos desde el momento de la integración, con visibilidad de hasta **48 horas hacia atrás**. # Branding Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/branding Personaliza cómo aparece tu marca en las notificaciones de facturación, cobranza y en el portal de pagos. Ve a **Configuración de la organización → Branding**. *** ### Elementos de diseño **Logo** — haz clic en **+** y carga el logo de tu empresa. > El archivo debe ser `.png` con una resolución máxima recomendada de 200x200 px. **Color principal y color secundario** — selecciona los colores desde la paleta o ingresa el código hexadecimal (`#RGB`) directamente. *** ### Diseño de correo electrónico Elige entre tres plantillas de diseño para tus notificaciones: * **Classic** * **Modern** * **Admiral** *** ### Previsualización Antes de guardar puedes revisar cómo quedará el diseño en dos contextos: * **Emails** — notificaciones de facturación y cobranza * **Portal de pagos** — página de pago que ven tus clientes *** Guarda los cambios con el botón **Guardar**. *** # Correos Electronicos Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/correos-electronicos Configura desde qué dirección se enviarán las facturas, notificaciones de facturación y recordatorios de cobranza a tus clientes. Ve a **Configuración de la organización → Correos electrónicos**. *** ### **Correos electrónicos de clientes** Activa o desactiva las notificaciones automáticas que reciben tus clientes según el evento: | **Notificación** | **Cuándo se envía** | | :- | :- | | **Pago recurrente exitoso** | Cuando un pago recurrente es procesado correctamente | | **Pago recurrente fallido** | Cuando un pago recurrente falla — se informa el motivo al cliente | | **Pago único exitoso** | Cuando un pago es completado desde el portal de pagos | | **Transferencia registrada** | Cuando un pago es registrado mediante transferencia | | **Pago externo registrado** | Cuando un pago es registrado como pago externo | Usa **Previsualizar** para ver cómo se verá cada notificación antes de activarla. Guarda los cambios con **Guardar**. *** ### **Proveedores de correo electrónico** Por defecto, Piriod envía todos los correos desde sus propios dominios: | **Cuenta** | **Proveedor** | | :- | :- | | `invoices@on.piriod.com` | Piriod | | `payments@on.piriod.com` | Piriod | Si necesitas enviar desde tu propio dominio de correo, puedes conectar un proveedor externo desde **Conectar proveedor de correo electrónico**. > [!NOTE] > > La conexión con cuentas Gmail o Google Workspace vía SMTP ya no está disponible desde mayo de 2025 debido a cambios en las políticas de seguridad de Google. Si necesitas conectar tu propio dominio de correo, contáctanos a través del chat de soporte. # Cuenta Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/cuenta Configura la información básica de tu organización. Estos datos aparecerán en el encabezado de todas las facturas y documentos emitidos. Ve a **Configuración de la organización → Cuenta**. *** ### Información de la organización * **Nombre** — se completa por defecto al crear la cuenta. Recomendamos usar el nombre fiscal exacto de la organización. * **País** — se define al crear la cuenta. Si necesitas modificarlo, contáctanos a través del chat de soporte. * **Estado** — estado o región donde se encuentra la organización. Solo aparecen las opciones disponibles según el país seleccionado. * **Dirección** — dirección fiscal exacta de la organización. ### Información fiscal * **Número fiscal** — se completa al crear la cuenta y no es editable desde el panel. Para modificarlo, contáctanos a través del chat de soporte. ### Información de contacto * **Email** — correo corporativo de la organización. * **Teléfono** — número telefónico administrativo. * **Sitio web** — dirección web corporativa. Incluye el prefijo `http://` o `https://` según corresponda. ### Programas Beta de Piriod * **Funciones con acceso temprano** — activa esta opción para acceder a funcionalidades en fase beta antes de su lanzamiento oficial. *** Guarda los cambios con el botón **Guardar**. # Equipo Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/equipo Gestiona los usuarios que tienen acceso a tu organización en Piriod. Puedes ver los miembros activos, su tipo de cuenta y la fecha desde la que están activos. Ve a **Configuración → Equipo**. *** ### Invitar a un miembro 1. Haz clic en **Invitar personas** 2. Ingresa el email de la persona que deseas invitar 3. Confirma la invitación La persona recibirá un email con instrucciones para acceder a la organización. *** ### Tipos de cuenta | Tipo | Descripción | | :- | :- | | **Dueño del espacio** | Acceso total a la organización, incluyendo configuración y facturación | | **Administrador** | Acceso total a la organización, incluyendo configuración y facturación | | **Miembro** | Acceso a todas las funciones operativas, pero sin visibilidad de la configuración de la organización | > La diferencia entre roles no es lo que pueden hacer, sino lo que pueden ver. # Exportar Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/exportar Exporta la información de tu organización en Piriod para uso externo — reportes, control administrativo, análisis o compartir con otros equipos. Ve a **Configuración de la organización → Exportar**. > Para evitar errores durante la exportación, usa los filtros disponibles para acotar el rango de registros antes de exportar — por fecha, estado u otros criterios según el caso. Exportar volúmenes muy grandes de datos de una sola vez puede provocar que el proceso falle. *** ### Clientes 1. Ve a **Configuración → Exportar → Clientes → Ir a exportar** 2. Filtra los registros que necesitas y haz clic en **Previsualizar** 3. Confirma que la información es correcta y haz clic en **Exportar** *** ### Facturas 1. Ve a **Configuración → Exportar → Facturas → Ir a exportar** 2. Filtra los registros que necesitas y haz clic en **Previsualizar** 3. Confirma que la información es correcta y haz clic en **Exportar** *** ### Notas de crédito 1. Ve a **Configuración → Exportar → Notas de crédito → Ir a exportar** 2. Filtra los registros que necesitas y haz clic en **Previsualizar** 3. Confirma que la información es correcta y haz clic en **Exportar** *** ### Pagos 1. Ve a **Configuración → Exportar → Pagos → Ir a exportar** 2. Filtra los registros que necesitas y haz clic en **Previsualizar** 3. Confirma que la información es correcta y haz clic en **Exportar** *** ### Suscripciones 1. Ve a **Configuración → Exportar → Suscripciones → Ir a exportar** 2. Al exportar, Piriod genera un archivo `.ZIP` con 3 archivos Excel comprimidos que contienen la información completa de suscripciones, cupones de descuento y complementos *** ### Transferencias 1. Ve a **Configuración → Exportar → Transferencias → Ir a exportar** 2. Filtra los registros que necesitas y haz clic en **Previsualizar** 3. Confirma que la información es correcta y haz clic en **Exportar** # Facturacion Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/facturacion Desde esta sección puedes crear plantillas de email para el envío de documentos a tus clientes y configurar direcciones en copia oculta para las notificaciones de facturación. Ve a **Configuración de la organización → Facturación**. *** ### Plantillas de envío de facturas Las plantillas definen el asunto y el mensaje que recibirán tus clientes cuando les envíes una factura por email. Si no tienes ninguna plantilla creada, Piriod usará un mensaje por defecto. #### Crear una plantilla 1. Haz clic en **Crear una plantilla** 2. Completa los campos: * **Nombre** — identificador interno de la plantilla * **Asunto** — título del email que verá el cliente * **Mensaje** — cuerpo del email. Puedes personalizarlo con los siguientes tokens: | Token | Descripción | | :- | :- | | `Factura número` | Número del documento | | `Factura tipo` | Tipo de documento | | `Factura fecha` | Fecha de emisión | | `Cliente nombre` | Nombre del cliente destinatario | 3. Haz clic en **Guardar plantilla** > Para eliminar una plantilla, haz clic en **×** al lado derecho de la plantilla. *** ### CCO Emails Agrega hasta 3 direcciones de correo que recibirán con copia oculta todos los emails de facturación — incluyendo facturas recurrentes, facturas masivas, facturas manuales y órdenes. 1. En la sección **Preferencias de facturación**, haz clic en **Agregar email** 2. Ingresa la dirección de correo 3. Haz clic en **Guardar** # Facturacion De Piriod Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/facturacion-de-piriod Desde esta sección puedes gestionar tu suscripción a Piriod — ver tu plan actual, registrar un método de pago y revisar el historial de facturas emitidas por Piriod a tu organización. Ve a **Configuración de la organización → Facturación de Piriod**. *** ### Suscripción Muestra el resumen de tu plan actual, incluyendo el tipo de plan, la cantidad de usuarios activos y la fecha de tu próxima facturación. *** ### Método de pago Registra la tarjeta con la que se cobrará tu suscripción a Piriod. Haz clic en **Registrar una nueva tarjeta** y sigue el proceso de inscripción. *** ### Pagos Listado de todas las facturas que Piriod ha emitido a tu organización. Por cada documento puedes ver el tipo, número, fecha, vencimiento, monto y estado. Si hay facturas pendientes, puedes pagarlas directamente desde esta vista haciendo clic en **Pagar**. *** > Si tu organización tiene facturas vencidas, Piriod mostrará un aviso indicando que la cuenta está en proceso de suspensión. Para reactivarla, haz clic en **Pagar facturas pendientes** y regulariza los documentos pendientes. # Clientes Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/importar/clientes La importación por lote permite cargar múltiples clientes en Piriod desde un archivo, sin necesidad de crearlos manualmente. Ve a **Configuración de la organización → Importar → Clientes**. *** ### Requisitos del archivo * Formato: `CSV`, `XLSX` o `JSON` * Los nombres de las columnas deben coincidir exactamente con los definidos * Evita símbolos especiales (`# $ % & - /`), tildes y ñ * El orden de las columnas no afecta la importación Puedes descargar un archivo de ejemplo directamente desde la pantalla de importación o desde [aquí](https://docs.google.com/spreadsheets/d/1Vc0owZwukZOdYWwwE3gvBZzFpRmKyo9Y/edit?usp=sharing\&ouid=109386486582398522693\&rtpof=true\&sd=true). *** ### Estructura del archivo Una fila por cliente. Las columnas disponibles son: #### Campos obligatorios | Campo | Descripción | | :- | :- | | `name` | Nombre del cliente | | `address` | Dirección del cliente | | `email` | Email de facturación | | `state` | ID del estado, región o provincia | | `country` | ID del país | | `currency` | Moneda del cliente: `CLP`, `USD`, `MXN`, `EUR` | #### Campos condicionales | Campo | Descripción | | :- | :- | | `tax_id` | RUT, DNI, NIF o VAT del cliente. Obligatorio según el país | | `tax_settings__cl_activity_description` | Actividad económica o giro del cliente | #### Campos opcionales | Campo | Descripción | | :- | :- | | `phone` | Teléfono del cliente | | `website` | Sitio web del cliente | | `metadata` | Información adicional en formato clave/valor. Ej: `{"my_custom_data":"valor"}` | *** ### Importar el archivo 1. Haz clic en **Seleccionar un archivo** 2. Busca el archivo en tu equipo 3. Haz clic en **Importar** Si el archivo es válido, Piriod mostrará un mensaje de éxito indicando cuántos registros fueron importados. Si hay errores de formato o faltan columnas obligatorias, la importación no se realizará. *** ### Errores comunes * Faltan columnas obligatorias * Los nombres de las columnas no coinciden exactamente * RUTs inválidos para clientes de Chile — el sistema los valida automáticamente * El campo `metadata` no está en formato clave/valor correcto * IDs de país o estado inválidos *** Una vez completada la importación, los clientes estarán disponibles en **Contactos → Clientes**. # Consumo de planes Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/importar/consumo-de-planes La importación de consumo permite registrar el uso de los planes facturados según consumo — aquellos donde la cantidad cobrada no es fija sino que se calcula a partir de registros de uso del período. Puedes acceder a esta importación desde dos lugares: * **Configuración de la organización → Importar → Consumo de planes** * **Suscripciones → Registros de uso → Importar** *** ### Preparar el archivo 1. Haz clic en **Descarga el archivo base de importación** — el archivo ya viene con las líneas de suscripción pre-llenadas por Piriod 2. Completa únicamente las dos columnas marcadas: * `date_time` — una fecha dentro del ciclo de consumo que quieres reportar, en formato `YYYY-MM-DDTHH:MM` * `quantity` — cantidad consumida en ese ciclo (ej: `900` o `900.5`) > No modifiques las demás columnas — `subscription_line`, `customer_id`, `customer_name`, `product_name`, `plan_name`, `plan_usage_aggregation` y `next_billing` son generadas por Piriod y no deben alterarse. *** ### ¿Qué fecha debo ingresar en `date_time`? Esta es la columna que genera más confusión. El campo `date_time` **no es la fecha en que se emitirá la factura** — es una fecha que cae dentro del ciclo de consumo que estás reportando. Piriod funciona igual que una cuenta de electricidad: primero ocurre el consumo, luego se factura. Para saber qué ciclo reportar, mira la columna `next_billing` — esa es la fecha en que se emitirá la próxima factura. El consumo que debes reportar corresponde al ciclo **anterior** a esa fecha. **Ejemplo:** | `next_billing` | Ciclo de consumo a reportar | `date_time` válido | | :- | :- | :- | | `2026-06-01` | 1 al 31 de mayo | Cualquier fecha entre `2026-05-01` y `2026-05-31` | | `2026-05-01` | 1 al 30 de abril | Cualquier fecha entre `2026-04-01` y `2026-04-30` | > [!WARNING] > > Si ingresas una fecha posterior a `next_billing`, la importación fallará — Piriod no permite registrar consumos con una fecha que no corresponda al ciclo activo. *** ### Importar el archivo 1. Haz clic en **Seleccionar un archivo** 2. Selecciona el archivo completado en formato `XLSX`, `CSV` o `JSON` 3. Haz clic en **Importar** Si el archivo es válido, Piriod mostrará el estado de la importación con la cantidad de consumos importados exitosamente. > La importación es **todo o nada** — si alguna fila contiene un error (por ejemplo, una fecha fuera del ciclo), no se importará ningún registro del archivo. Piriod mostrará las filas con error para que puedas corregirlas antes de volver a intentarlo. *** ### Verificar el consumo importado Una vez importado correctamente puedes verificar el consumo de dos formas: **Desde la suscripción** — ve al detalle de la suscripción, en la sección **Planes** haz clic en **Ver consumo**. Se mostrará el detalle de cada registro con su fecha y cantidad. ![Captura De Pantalla 2026 06 05 A La(s) 16 25 28 1](https://mintcdn.com/piriod-d406ac55/W9ZX3ngcqjLtly-u/images/Captura-de-pantalla-2026-06-05-a-la\(s\)-16.25.28-1.png?fit=max\&auto=format\&n=W9ZX3ngcqjLtly-u\&q=85\&s=934b9bacdb020ee778cab11acddaeddd) **Desde el registro de uso** — ve a **Suscripciones → Registros de uso** para ver todos los consumos informados de todas las suscripciones, con el cliente, plan, canal, cantidad y marca de tiempo de cada registro. ![Captura De Pantalla 2026 06 05 A La(s) 16 27 07 1](https://mintcdn.com/piriod-d406ac55/W9ZX3ngcqjLtly-u/images/Captura-de-pantalla-2026-06-05-a-la\(s\)-16.27.07-1.png?fit=max\&auto=format\&n=W9ZX3ngcqjLtly-u\&q=85\&s=e224af61448eec502ac78abb387ee8f2) # Importar Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/importar/importar ## Importar Importa información a Piriod de forma masiva mediante un archivo — útil cuando estás migrando desde otro sistema o quieres evitar crear registros uno por uno. Ve a **Configuración de la organización → Importar**. # Notificaciones Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/notificaciones Piriod te avisa cuando ocurren eventos relevantes en tu organización: un cobro que falla, un cliente que registra o actualiza su tarjeta, entre otros. Puedes verlas dentro de la plataforma, recibirlas por correo, o ambas cosas, y cada integrante de tu equipo decide qué avisos quiere recibir y por qué canal. *** ## Qué te notifica Piriod **Cobro fallido** Cuando un cobro a una tarjeta guardada de un cliente es rechazado, tu organización recibe una notificación con el cliente, el monto y el motivo del rechazo. Antes, este aviso llegaba únicamente al cliente final, y el equipo solo se enteraba si entraba a revisar los pagos manualmente. Los correos que reciben tus clientes cuando falla un cobro no cambian. Si un cobro masivo rechaza varias tarjetas al mismo tiempo, no recibes una notificación por cada una: Piriod las agrupa en un solo aviso con el total de tarjetas afectadas. **Registro o actualización de tarjeta** También te avisa cuando un cliente registra su tarjeta, distinguiendo si es la primera vez o si está reemplazando una que ya tenía guardada. Este segundo caso suele ser una señal útil para cobranza: es habitual que un cliente moroso registre una tarjeta nueva justo antes de habilitar un cobro pendiente. ![Captura Correo Resumen 1](https://mintcdn.com/piriod-d406ac55/7wMHcWUnM6PCDYLy/images/captura_correo-resumen_1.png?fit=max\&auto=format\&n=7wMHcWUnM6PCDYLy\&q=85\&s=3a048c472daaac310d269736f60affb9) *** ## Dónde verlas: el centro de notificaciones El ícono de campana, en la barra superior del dashboard, ahora concentra todas tus notificaciones. * El número sobre el ícono indica cuántas notificaciones no has leído. * Al hacer clic en una notificación, Piriod te lleva directo al pago o cliente relacionado. * Usa **Marcar todas como leídas**, arriba a la derecha del panel, para limpiar el contador de una vez. ![Captura Campana Notificaciones 1](https://mintcdn.com/piriod-d406ac55/7wMHcWUnM6PCDYLy/images/captura_campana-notificaciones_1.png?fit=max\&auto=format\&n=7wMHcWUnM6PCDYLy\&q=85\&s=9ea20142156cb8dfd9bfe76d56fe4a13) *** ## Cómo elegir qué recibir: preferencias de notificaciones Ve a **Configuración de la organización → Notificaciones** para decidir qué avisos quieres recibir y por qué canal (dentro del dashboard, por correo, o ambos). * La configuración es personal, no del equipo: lo que elijas no afecta a tus compañeros. * Es además por organización: si perteneces a varias, puedes recibir todo en una y nada en otra. * El interruptor **Silenciar todas mis notificaciones**, arriba a la derecha, desactiva cualquier aviso sin necesidad de apagar cada categoría por separado. * En **Frecuencia del resumen por correo** eliges cada cuánto quieres recibir el correo con tus notificaciones (ver la siguiente sección). Este control aplica solo al canal de correo: dentro del dashboard, las notificaciones siempre llegan al instante. > [!NOTE] > > Según los módulos que tenga habilitados tu organización, es posible que veas categorías adicionales en esta pantalla. ![Captura Configuracion Notificaciones 1](https://mintcdn.com/piriod-d406ac55/7wMHcWUnM6PCDYLy/images/captura_configuracion-notificaciones_1.png?fit=max\&auto=format\&n=7wMHcWUnM6PCDYLy\&q=85\&s=ae7a2bf63751460252732db585b12ac4) *** ## El resumen por correo Para que no dependas de entrar al dashboard, tus notificaciones también pueden llegarte por correo. En vez de un correo por cada evento, Piriod los agrupa en un resumen: si un cobro masivo produce cientos de rechazos, igual recibes un solo correo. Elige la frecuencia en **Configuración de la organización → Notificaciones → Frecuencia del resumen por correo**: * Cada 30 minutos * Una vez al día * No recibirlo ![Image (64) Copia2](https://mintcdn.com/piriod-d406ac55/7wMHcWUnM6PCDYLy/images/image-\(64\)-copia2.png?fit=max\&auto=format\&n=7wMHcWUnM6PCDYLy\&q=85\&s=402f099d710f743b252776c9c3bf7e0f) El correo respeta el logo y los colores de tu organización (definidos en [Configuración de la organización → Branding](/guia/configuracion-de-la-organizacion/branding)), y trae un enlace directo a tus preferencias de notificaciones para que puedas ajustarlas sin volver al dashboard. *** Para más información sobre cómo se registran las tarjetas de tus clientes, revisa [Ingresos → Tarjetas](/guia/ingresos/tarjetas). # Pagos Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/pagos Configura cómo se mostrarán las opciones de pago por transferencia en el portal de pagos de tus clientes. Ve a **Configuración de la organización → Pagos**. *** ### Pagos por transferencia Cuando activas esta opción, los datos de tu cuenta bancaria aparecen en el portal de pagos para que tus clientes puedan realizar transferencias manuales. 1. Activa **Mostrar extracto de cuenta bancaria** 2. Ingresa los datos de tu cuenta en el campo **Extracto de cuenta bancaria** 3. Haz clic en **Guardar** # Programa de referidos Source: https://docs.piriod.com/guia/configuracion-de-la-organizacion/programa-de-referidos Invita a otras empresas a Piriod con tu enlace personal y recibe crédito por cada una que se convierta en cliente. El **programa de referidos** te permite invitar a otras empresas a Piriod con un enlace propio y recibir crédito por cada una que se convierta en cliente. El enlace pertenece al usuario, no a la organización. Cada persona tiene el suyo, aunque comparta organización con otras. Ve a **Menú de usuario → Programa de referidos**. ![Referidos 01 Menu](https://mintcdn.com/piriod-d406ac55/vccts-DldRDPLuje/images/referidos-01-menu.png?fit=max\&auto=format\&n=vccts-DldRDPLuje\&q=85\&s=79a22c29d0e4698f341b207d09d18962) Abre el menú de tu perfil y entra a Programa de referidos. *** ## Quién puede participar Cualquier usuario con cuenta activa en Piriod, incluidos los del plan gratuito. > [!NOTE] > > **Requisito:**\ > Necesitas al menos una organización creada y seleccionada como beneficiaria. Ahí se acreditan tus recompensas, y sin ella no puedes referir. *** ## Cómo funciona 1. **Compartes tu enlace.** Lo copias desde tu cuenta y se lo envías a quien quieras invitar. El enlace te identifica como referidor. 2. **Tu invitado se registra y crea su organización.** Desde ese momento queda asociada a ti. 3. **Paga su primera factura.** Cuando se confirma el pago, se acreditan CLP 45.000 en tu organización beneficiaria. *** ## La recompensa Cada referido válido vale **CLP 45.000 en crédito**, sin importar tu plan ni el que contrate tu referido. * Se descuenta automáticamente de la próxima factura de suscripción de tu organización beneficiaria. * Si el crédito supera el monto de la factura, el saldo queda a favor para las siguientes. * Aplica solo a suscripciones de Piriod. No cubre servicios de terceros ni cargos externos. * No es transferible a otra persona u organización. * No hay límite de referidos. > [!NOTE] > > **Vigencia:**\ > Cada crédito dura 90 días desde que queda disponible para aplicarse a una factura de suscripción. > [!NOTE] > > **Sobre CLP 250.000 acumulados:**\ > Si tus créditos superan ese monto, te contactamos para acordar cómo te lo pagamos. *** ## Configurar tu organización beneficiaria Como puedes pertenecer a más de una organización, tienes que indicar cuál recibe tus créditos. 1. Ve a **Menú de usuario → Programa de referidos**. 2. En **Organización beneficiaria**, abre el selector y elige una. ![Referidos 02 Beneficiaria](https://mintcdn.com/piriod-d406ac55/vccts-DldRDPLuje/images/referidos-02-beneficiaria.png?fit=max\&auto=format\&n=vccts-DldRDPLuje\&q=85\&s=18cd7269bd957c37faab866733278af0) El selector está vacío hasta que elijas una organización. > [!WARNING] > > **Advertencia:**\ > No hay organización seleccionada por defecto. Sin este paso no puedes referir, porque los créditos no tendrían dónde acreditarse. *** ## Compartir tu enlace En **Copia y comparte tu enlace único de referidos** está tu dirección personal: ```text theme={null} https://app.piriod.com/signup?referral=ref_XXXXXX ``` Haz clic en **Copiar** y compártelo por correo, WhatsApp, LinkedIn o donde prefieras. Todo registro que entre por ese enlace queda asociado a ti. ![Referidos 03 Enlace](https://mintcdn.com/piriod-d406ac55/vccts-DldRDPLuje/images/referidos-03-enlace.png?fit=max\&auto=format\&n=vccts-DldRDPLuje\&q=85\&s=17d57863f4b2b54581b6d7458bf5e9ad) Cada usuario tiene su propio código al final del enlace. > [!NOTE] > > **Nota:**\ > Comparte siempre el enlace completo. Si tu invitado entra directo al sitio sin él, el referido no queda registrado. *** ## Hacer seguimiento En **Organizaciones referidas** ves las empresas que se registraron con tu enlace y el estado de cada una. Si todavía no tienes invitaciones, vas a ver el mensaje *"Aún no tienes organizaciones referidas"*. Aparecen apenas alguien se registre con tu enlace. ![Referidos 04 Referidas](https://mintcdn.com/piriod-d406ac55/vccts-DldRDPLuje/images/referidos-04-referidas.png?fit=max\&auto=format\&n=vccts-DldRDPLuje\&q=85\&s=4ef79787645b5ab30b118bdb89465376) Vista sin referidos todavía. Cuando ya tengas referidos, cada empresa aparece con su fecha de registro, su estado y la recompensa asociada. Mientras el referido no pague su primera factura, la recompensa queda pendiente. ![Referidos 04 Referidas (1)](https://mintcdn.com/piriod-d406ac55/vccts-DldRDPLuje/images/referidos-04-referidas-\(1\).png?fit=max\&auto=format\&n=vccts-DldRDPLuje\&q=85\&s=69fdc0e495688a8574beb646a83da286) Ejemplo de listado con referidos. *** ## Reglas del programa | Regla | Condición | | :- | :- | | Quién puede participar | Cualquier usuario con cuenta activa, incluidos los del plan gratuito | | Requisito para referir | Tener una organización creada y seleccionada como beneficiaria | | A quién pertenece el enlace | Al usuario. Cada persona tiene el suyo | | Recompensa | CLP 45.000 en crédito por referido válido | | Cuándo se acredita | Cuando se confirma el pago de la primera factura del referido | | Plazo de acreditación | Automático. No requiere solicitud ni gestión | | Cuántas veces cuenta un referido | Una sola vez, aunque cree varias organizaciones | | Límite de referidos | Sin límite | | Vigencia del crédito | 90 días desde que queda disponible para aplicarse | | Cambios al programa | Piriod puede modificar montos y condiciones. Los créditos ya acreditados se respetan | *** ## Qué cuenta como referido válido Las tres condiciones tienen que cumplirse: * Empresa **nueva**, sin cuenta previa en Piriod. * Registrada **con tu enlace**, no entrando directo al sitio. * Con su **organización creada** y su **primera factura pagada**. ### Qué no cuenta * **Autoreferencia:** organizaciones tuyas o de empresas del mismo grupo o con los mismos dueños. * **Cuentas que ya están en el pipeline comercial de Piriod** con comunicación verificada en los últimos 90 días. * **Cuentas que no llegan a pagar** su primera factura. * **Pagos revertidos o anulados:** contracargo, devolución o rechazo posterior. * **Registros duplicados** de una misma empresa. * **Cuentas creadas con datos falsos** o inexistentes. > [!WARNING] > > **Advertencia:**\ > Piriod se reserva el derecho de anular una recompensa cuando detecte uso indebido del programa. Si crees que tu caso es una excepción, escríbenos a [**elias@piriod.com**](mailto:elias@piriod.com) y lo vemos. *** ## Preguntas frecuentes > **¿Necesito ser cliente pagador para referir?** > > No. Cualquier usuario con cuenta activa puede referir, incluso en el plan gratuito. Lo único que necesitas es una organización creada y seleccionada como beneficiaria. > **Somos varios en la misma empresa, ¿compartimos el enlace?** > > No. Cada usuario tiene su propio enlace y sus propios créditos. Pueden referir por separado sin interferir entre sí. > **¿Y si mi referido cancela su suscripción después?** > > El crédito se mantiene. Lo que define la recompensa es el pago de su primera factura, no cuánto tiempo se quede. Solo se anula si ese pago fue revertido. > **¿Qué pasa si mi referido crea varias organizaciones?** > > Cuenta como un solo referido, sin importar cuántas cree. > **¿Puedo pedir el monto en dinero en vez de crédito?** > > El beneficio se entrega como crédito. Si acumulas más de CLP 250.000, te contactamos para acordar cómo te lo pagamos. > **¿Mi invitado recibe algún beneficio?** > > Por ahora la recompensa es solo para quien refiere. Podría incorporarse más adelante. > **¿Puedo referir a una empresa que ya hablaba con Piriod?** > > No, si ya está en el pipeline comercial con comunicación verificada en los últimos 90 días. Para revisar excepciones, escribe a **[elias@piriod.com](mailto:elias@piriod.com)**. # Clientes Source: https://docs.piriod.com/guia/contactos/clientes En Piriod, los clientes representan a tus suscriptores, ya sean empresas (B2B) o personas naturales (B2C). Cada cliente centraliza toda la información necesaria para gestionar la relación comercial y automatizar la facturación y los cobros — datos de contacto, información fiscal, métodos de pago, historial de facturación y suscripciones activas. *** ### Crear un cliente **Contactos → Clientes → Nuevo** Completa la información básica, fiscal y de contacto, luego haz clic en **Crear cliente**. Una vez creado, el cliente quedará disponible para asociar suscripciones, emitir documentos y registrar pagos. También puedes crear clientes de otras formas: * **Por lote** — carga un archivo estructurado para crear múltiples clientes a la vez. Consulta la guía de **importación de clientes** * **Desde Signup Forms** — tus clientes se registran de forma autónoma al suscribirse a un plan * **Vía API** — usa el recurso **Create a customer** para sincronizar desde otros sistemas *** ### Listado de clientes Desde **Contactos → Clientes** puedes ver todos tus clientes, filtrarlos y acceder al detalle de cada uno. ![Image (33)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(33\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=0fcf37348304f5a3aca5ea2fa5e565af) *** ### Detalle de un cliente Al abrir un cliente puedes ver toda su información relacionada: * **Resumen transaccional** — ventas totales, ventas del mes y balance * **Información general** — nombre, ID fiscal y datos de contacto * **Información de facturación** — configuración para emisión de documentos * **Tarjetas** — métodos de pago registrados. Ver [Tarjetas](https://docs.piriod.com/guide/revenues/tarjetas) * **Últimos pagos y facturas** — acceso rápido al historial reciente * **Suscripciones** — activas, pausadas y finalizadas * **Unidades organizativas** — áreas internas del cliente (ver más abajo) * **Metadatos** — información personalizada en pares clave-valor *** ### Acciones disponibles Desde la parte superior derecha del detalle del cliente tienes acceso a las siguientes acciones: ![Image (34)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(34\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=4848151ddd8d14103a08d2e056070e0a) #### Enviar deuda Envía un email al cliente con el detalle consolidado de todas sus facturas pendientes. El correo incluye un resumen de documentos, montos, fechas de vencimiento, las facturas adjuntas en PDF y un botón de pago por cada documento. 1. Haz clic en **Enviar deuda** 2. Selecciona el destinatario 3. Ingresa el asunto 4. Ajusta el mensaje si lo deseas 5. Haz clic en **Enviar** ![Image (36)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(36\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=714b8966fe5df1dbabc43c23495ec455) #### Editar Modifica la información básica, fiscal o de contacto del cliente en cualquier momento. 1. Haz clic en **Editar** 2. Actualiza la información 3. Haz clic en **Guardar** ![Image (35)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(35\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=94953b741f88ce4118313f27012fed6e) > [!NOTE] > > En organizaciones donde la validación fiscal es realizada por una autoridad tributaria, el **ID fiscal no puede modificarse** una vez creado el cliente. #### Configurar mensajería Define qué tipos de correos automáticos puede recibir el cliente. Si deshabilitas un tipo, el cliente dejará de recibir esas notificaciones. Tipos disponibles: * **Facturas** — correos al emitir documentos * **Cobranzas** — recordatorios de pago pendiente * **Comprobantes de pago** — confirmaciones al registrar un pago Los cambios se guardan automáticamente. #### Archivar Desactiva el cliente sin eliminar su información ni historial. El cliente deja de aparecer en los listados activos pero sus datos siguen disponibles para consulta. Recomendado cuando el cliente ya no tiene actividad comercial o tiene registros asociados que deben conservarse. > [!WARNING] > > Esta acción no se puede deshacer. #### Eliminar Elimina permanentemente el cliente. Solo disponible cuando no tiene registros asociados — tarjetas, suscripciones, facturas o pagos. Si tiene historial, usa **Archivar** en su lugar. > [!WARNING] > > Esta acción no se puede deshacer. *** ### Unidades organizativas Las unidades organizativas permiten estructurar áreas internas de un cliente empresa — departamentos, sucursales, divisiones — y asignar personas específicas a cada una para dirigir correctamente las notificaciones de facturación y cobros. #### Crear una unidad organizativa 1. Ve al detalle del cliente 2. Dirígete a la sección **Unidades organizativas** 3. Haz clic en **+ Nuevo** 4. Ingresa el nombre 5. Haz clic en **Crear** También puedes crearlas vía API usando el recurso **Create a org unit**. #### Asignar personas a una unidad organizativa 1. Asegúrate de que el cliente tenga al menos una unidad organizativa creada 2. Ve al detalle de la persona 3. Selecciona la unidad organizativa correspondiente El cambio se guarda automáticamente. # Personas Source: https://docs.piriod.com/guia/contactos/personas Las personas representan contactos reales asociados a un cliente. Permiten almacenar información de contacto y definir qué notificaciones recibirá cada una — facturas, cobranzas o comprobantes de pago. Un cliente puede tener múltiples personas asociadas. *** ### Crear una persona **Contactos → Personas → Nuevo** 1. Completa la información de contacto 2. Activa o desactiva las notificaciones que correspondan 3. Haz clic en **Crear persona** También puedes crearlas vía API usando el recurso **Create a contact**. *** ### Vincular una persona a un cliente Una persona puede crearse de forma independiente y luego vincularse a un cliente. 1. Ve al detalle de la persona 2. Haz clic en **Vincular cliente** 3. Selecciona el cliente correspondiente 4. Confirma la selección ![Image (37)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(37\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=ffc0b9a27e3c30cb19820e09632c562b) *** ### Editar una persona 1. Ve al detalle de la persona 2. Haz clic en **Editar** 3. Actualiza la información de contacto y las preferencias de notificación 4. Haz clic en **Guardar** # Facturación Masiva Source: https://docs.piriod.com/guia/facturacion-masiva Emite muchas facturas de una vez cargando un archivo con los datos de cada una. Con la facturación masiva subes un archivo Excel o CSV con los datos de tus facturas y Piriod las crea todas en un solo proceso. Antes de emitirlas puedes revisar el resultado, y si quieres, enviarlas por email a cada cliente al mismo tiempo. ## Para qué te sirve Te permite emitir en pocos minutos un volumen de facturas que a mano tomaría mucho más tiempo. Puedes cargar hasta **1.000 facturas en un solo proceso**: preparas el archivo una vez, lo subes, revisas el resumen y apruebas. Si necesitas emitir más, divide el archivo en varios procesos. Además, el archivo que subiste queda guardado en el proceso, así que puedes volver a descargarlo cuando lo necesites. ## Antes de empezar 1. **Tus clientes deben estar creados en Piriod.** El nombre en el archivo tiene que estar escrito igual a como está registrado. 2. **Los documentos que vas a emitir deben estar habilitados para tu empresa** (revisa [Facturas](/guia/facturacion/facturas)). 3. **Ten a mano el archivo base.** Descárgalo aquí: [Archivo base de facturación masiva](https://docs.google.com/spreadsheets/d/1bc26v0gzmEYX1-ra5mLiGo0WwQSqckmE/edit?usp=sharing\&ouid=109386486582398522693\&rtpof=true\&sd=true). Trae todas las columnas con sus nombres y algunos ejemplos que puedes reemplazar. El orden de las columnas no importa: Piriod lee el archivo igual, siempre que tenga las obligatorias. ## Cómo armar el archivo Cada fila del archivo es una línea de producto. Así se arma una factura: 1. **La primera fila de cada factura** lleva los datos del documento (fecha, cliente, tipo de documento, vencimiento) y su primer producto. 2. **Si la factura tiene más productos,** agrega una fila debajo por cada uno, completando solo las columnas del producto (las que empiezan con `line_`). Deja vacías las demás. 3. **Cuando una fila vuelve a tener fecha y cliente,** empieza una factura nueva. ![Facturacion Masiva Archivo Ejemplo](https://mintcdn.com/piriod-d406ac55/rCt9xA36MoRxHAgr/images/facturacion-masiva-archivo-ejemplo.png?fit=max\&auto=format\&n=rCt9xA36MoRxHAgr\&q=85\&s=86de2a81af0ea78a3f59724ef22aee62) > [!WARNING] > > **Evita los caracteres especiales en documentos tributarios de Chile.** El SII puede rechazar facturas que tengan tildes, ñ, símbolos (como / \_ ? ' & ") o guiones largos. Escribe sin ellos el nombre de los productos, las notas y las descripciones de las referencias. Por ejemplo, "Reparacion de vehiculo" en lugar de "Reparación de vehículo". ### Columnas obligatorias
Columna Qué va
`date` Fecha de emisión, en formato AAAA-MM-DD.
`customer` Nombre del cliente, escrito igual a como está registrado en Piriod.
`document` Código del tipo de documento. Por ejemplo, `CL33` para factura electrónica, `US1` para Invoice o `US6` para Recibo (revisa la lista completa en [Tipos de documentos](/guia/recursos/tipos-de-documentos)).
`due_date` Fecha de vencimiento, en formato AAAA-MM-DD.
`collection_method` Siempre va `deferred`.
`line_name` Nombre del producto o servicio.
`line_amount` Precio unitario.
`line_quantity` Cantidad.
> [!NOTE] > > Puedes identificar al cliente con `customer` o con `tax_id` (su RUT o identificador tributario). Si completas las dos columnas, Piriod usa `customer`. ### Columnas opcionales
Columna Qué va
`tax_id` RUT o identificador tributario del cliente.
`line_discount` Descuento de la línea.
`line_discount_scheme` Tipo de descuento de la línea: `%` o `$`.
`line_code` Código del producto.
`line_code_scheme` Tipo de código, por ejemplo, `SKU`.
`discount` Descuento sobre el total de la factura.
`discount_scheme` Tipo de descuento de la factura: `%` o `$`.
`reference_document` Código del documento de referencia. Por ejemplo, `CL801` para orden de compra o `CLHES` para hoja de entrada de servicios (revisa la lista en [Tipos de documentos](/guia/recursos/tipos-de-documentos#lista-de-referencias)).
`reference_serial` Número o identificador del documento de referencia.
`reference_date` Fecha del documento de referencia, en formato AAAA-MM-DD.
`reference_description` Descripción de la referencia.
`note` Comentario que aparece en la factura.
`tax_settings_cl_payment_type` Forma de pago en documentos de Chile: `1` contado, `2` crédito, `3` sin costo.
## Estados de un proceso En **Facturación → Facturas → Nuevo → Facturación masiva** ves todos tus procesos y puedes filtrarlos con las pestañas **Pendiente**, **Procesando** y **Finalizado**. | Estado | Qué significa | Qué puedes hacer | | :- | :- | :- | | **Pendiente** | El archivo se cargó bien, pero las facturas todavía no se crean. | Revisar el resumen y aprobar el proceso, o eliminarlo. | | **Procesando** | Piriod está creando las facturas. | Esperar a que termine. | | **Finalizado** | Las facturas ya se crearon. | Revisarlas desde el proceso o desde **Facturas**. | ## Paso a paso ### Crear un proceso de facturación masiva **1. Abre la facturación masiva** Ve a **Facturación → Facturas**, haz clic en **Nuevo** y elige **Facturación masiva**. Luego haz clic en **Nuevo** o en **Crear facturación masiva**. ![Facturacion Masiva Nuevo](https://mintcdn.com/piriod-d406ac55/rCt9xA36MoRxHAgr/images/facturacion-masiva-nuevo.png?fit=max\&auto=format\&n=rCt9xA36MoRxHAgr\&q=85\&s=fbc61e2988a95a93b9208b760262c710) **2. Sube tu archivo** 1. **Fuente de datos:** haz clic en el clip y elige tu archivo. 2. **Formato:** elige el formato del archivo, `xlsx` o `csv`. También existe `json`, pensado para integraciones. **3. Elige las opciones del proceso** 1. **Generar sólo borradores:** las facturas se crean como borrador, sin emitirse. Te sirve para revisar que todo quedó bien antes de emitir. 2. **Enviar vía email al cliente:** cada factura se envía a su cliente apenas se emite. Esta opción no está disponible si generas solo borradores, porque un borrador todavía no es una factura emitida. ![Facturacion Masiva Formulario Completo](https://mintcdn.com/piriod-d406ac55/rCt9xA36MoRxHAgr/images/facturacion-masiva-formulario-completo.png?fit=max\&auto=format\&n=rCt9xA36MoRxHAgr\&q=85\&s=a6044dcb179c2b7432e56c808afdfce3) **4. Revisa el resumen** Haz clic en **Continuar**. Si el archivo está correcto, se crea el proceso en estado **Pendiente** y ves el resumen: la cantidad de facturas, las opciones que elegiste y cada factura con su cliente, documento, fecha, vencimiento y total. ![Facturacion Masiva Proceso Cargado](https://mintcdn.com/piriod-d406ac55/rCt9xA36MoRxHAgr/images/facturacion-masiva-proceso-cargado.png?fit=max\&auto=format\&n=rCt9xA36MoRxHAgr\&q=85\&s=05e5eca348b99b1fd20ccf7b2f49be33) **5. Aprueba el proceso** Haz clic en **Aprobar todo** y luego en **Continuar**. El proceso pasa a **Procesando** y, cuando termina, a **Finalizado**. > [!WARNING] > > Esta acción no se puede deshacer. Al aprobar, las facturas se emiten y, si activaste el envío por email, se envían a cada cliente. Si algo no está bien en el resumen, elimina el proceso con **Eliminar proceso** y vuelve a subir el archivo corregido. > [!TIP] > > Recomendación: Si vas a emitir muchas facturas, haz primero una prueba con **Generar sólo borradores**. Revisa que los clientes, los productos y los totales estén bien, elimina ese proceso y vuelve a subir el archivo con la opción desactivada. Así, al aprobar, todas las facturas se emiten de una vez. ## Qué pasa después Cuando el proceso queda en **Finalizado**, verás cada factura con su número y en estado **Pendiente de pago**. Si generaste solo borradores, aparecen como **Borrador**. Desde el proceso puedes: 1. **Ver todas las facturas:** abre la lista de facturas creadas en ese proceso. 2. **Descargar archivo:** descarga el mismo archivo que subiste. 3. **Eliminar proceso:** disponible mientras el proceso está **Pendiente**, o cuando lo generaste solo con borradores. Cada factura emitida funciona igual que una factura única: tiene su pago asociado, puedes enviarla, descargar su PDF o crear una nota de crédito (revisa [Facturas](/guia/facturacion/facturas)). ![Facturacion Masiva Finalizado](https://mintcdn.com/piriod-d406ac55/tmDiHq7o_qLGOfxB/images/facturacion-masiva-finalizado.png?fit=max\&auto=format\&n=tmDiHq7o_qLGOfxB\&q=85\&s=68c4f0038059d7154f5021f12c3e0cc6) ## Problemas frecuentes Si el archivo tiene un error, al hacer clic en **Continuar** aparece un aviso rojo y el proceso no se crea. El aviso indica la factura con el problema (por ejemplo, **Factura 3**). Ese número es el orden de la factura dentro del archivo, no el número de la fila en Excel. > **Aparece el error Cliente: Este campo no puede ser nulo** > > **Por qué pasa:** Piriod no encontró al cliente de esa factura. Lo más común es que el nombre en la columna `customer` no esté escrito igual a como está registrado en Piriod (por ejemplo, tiene un espacio de más, una letra distinta o usa otra razón social). > > **Cómo resolverlo:** > > 1. Cuenta las facturas en tu archivo hasta llegar al número que indica el aviso. > 2. Copia el nombre del cliente desde su ficha en Piriod y pégalo en la columna `customer`. > 3. Vuelve a subir el archivo. > **Aparece el error Clave primaria inválida - objeto no existe** > > **Por qué pasa:** el código de un documento no existe en Piriod. El aviso indica qué código falló y en qué parte: si dice **Api.references**, es el código de la columna `reference_document`. > > **Cómo resolverlo:** reemplaza el código por el que usa Piriod. Por ejemplo, `CLHES` en lugar de `HES`, o `CL801` en lugar de `801`. La lista completa está en [Tipos de documentos](/guia/recursos/tipos-de-documentos). > **Los productos de una misma factura quedaron en facturas separadas** > > **Por qué pasa:** repetiste la fecha y el cliente en cada fila. Cada fila con esos datos empieza una factura nueva. > > **Cómo resolverlo:** en las filas de los productos adicionales, deja vacías todas las columnas que no empiezan con `line_`. > **No puedo activar Enviar vía email al cliente** > > **Por qué pasa:** tienes activada la opción **Generar sólo borradores**. Un borrador todavía no es una factura emitida, por eso no se puede enviar. > > **Cómo resolverlo:** desactiva **Generar sólo borradores** si quieres emitir y enviar en el mismo proceso. > **Aprobé el proceso y las facturas quedaron como borrador** > > **Por qué pasa:** el proceso se creó con **Generar sólo borradores** activado. > > **Cómo resolverlo:** revisa los borradores y, si están bien, elimina el proceso y vuelve a subir el archivo con esa opción desactivada. También puedes emitir cada borrador a mano desde **Facturación → Facturas**. > **No me aparece el botón Eliminar proceso** > > **Por qué pasa:** el proceso ya se aprobó y las facturas se emitieron. Una factura emitida no se puede eliminar. > > **Cómo resolverlo:** si necesitas anular alguna factura, crea una nota de crédito (revisa [Notas de crédito](/guia/facturacion/notas-de-credito)). > [!TIP] > > ¿Tienes una duda que no aparece aquí? Escríbenos a soporte e incluye el ID del proceso (aparece en el encabezado y empieza con `bul_`). Así podemos ayudarte más rápido. ## Siguientes pasos > **[Facturas](/guia/facturacion/facturas)** > > Revisa, envía y gestiona cada factura emitida. > **[Tipos de documentos](/guia/recursos/tipos-de-documentos)** > > Consulta los códigos de documentos y referencias para tu archivo. > **[Pagos](/guia/ingresos/pagos/pagos)** > > Sigue el cobro de las facturas que emitiste. > **[Notas de crédito](/guia/facturacion/notas-de-credito)** > > Corrige o anula una factura emitida. # Facturas Source: https://docs.piriod.com/guia/facturacion/facturas Crea, emite y envía facturas y boletas a tus clientes desde el panel. Una factura es el documento con el que le cobras a tu cliente. En Piriod puedes crearla desde el panel, elegir si tiene validez fiscal o no, y enviarla por email con un botón para que tu cliente pague en línea. ## Para qué te sirve Con las facturas únicas puedes emitir un documento cuando lo necesites, con los productos, el tipo de documento y la forma de pago que elijas. Una vez emitida, se la envías a tu cliente con un botón para que pague en línea y sigues su cobro desde Piriod. Si no necesitas un documento tributario, también puedes emitir un Invoice o un Recibo como comprobante de venta. Piriod también puede emitir tus facturas de otras formas: varias a la vez con la facturación masiva (revisa [Facturación masiva](/guia/facturacion-masiva)), o de forma automática con las suscripciones (revisa [Facturas recurrentes](/guia/suscripciones/facturas-recurrentes)). ## Antes de empezar 1. **Tu cliente debe estar creado en Piriod.** La factura siempre se emite a un cliente registrado. 2. **Para emitir documentos con validez fiscal, tu empresa debe estar habilitada para facturar en su país.** En la lista **Tipo de factura** solo aparecen los documentos disponibles para tu empresa. Revisa los requisitos en [Facturación incorporada](/guia/integraciones/procesadores-de-facturacion/piriod-facturacion-incorporada) (Chile), [Facturapi](/guia/integraciones/procesadores-de-facturacion/facturapi) (México) o [Plemsi](/guia/integraciones/procesadores-de-facturacion/plemsi) (Colombia). Si tienes dudas, escríbenos a soporte. 3. **Si vas a emitir una factura de exportación, tu cliente debe tener una moneda distinta a CLP.** 4. **Si quieres que tu cliente pague en línea, necesitas al menos un medio de pago conectado** (revisa [Procesadores de pago](/guia/integraciones/procesadores-de-pago/procesadores-de-pago)). ## Tipos de documento En Piriod puedes emitir dos tipos de documentos: 1. **Documentos con validez fiscal:** por ahora, Piriod emite documentos tributarios en **Chile, México, Brasil y Colombia**. El tipo de documento lo define la autoridad fiscal de cada país. Al emitirlo, se envía automáticamente a esa autoridad, así que no tienes que hacerlo por tu cuenta. 2. **Documentos genéricos (Invoice y Recibo):** sirven como comprobante de venta, pero no tienen validez fiscal y no se envían a ninguna autoridad fiscal. Puedes emitirlos en cualquier país y en cualquier moneda, cada vez que no necesites un documento tributario. Por ejemplo, si le cobras a un cliente de un país donde Piriod no tiene facturación local, o si tu organización no emite documentos tributarios, como una institución sin fines de lucro. En el campo **Tipo de factura** vas a ver dos grupos: los documentos **Genéricos** y los documentos con validez fiscal del país de tu empresa. | Grupo | Documentos | Validez fiscal | | :- | :- | :- | | **Genéricos** | Invoice y Recibo | No. Sirven como comprobante de venta y aparecen siempre, en cualquier país. | | **Chile** | Factura electrónica, Factura exenta electrónica, Boleta electrónica, Boleta exenta electrónica, Factura electrónica de exportación, entre otros | Sí. Se validan con el SII al emitirlos. | | **México** | Factura de ingreso | Sí. Se envía al SAT al emitirla. | | **Brasil** | Nota fiscal de servicio | Sí. Se envía a la Receita Federal al emitirla. | | **Colombia** | Factura electrónica | Sí. Se envía a la DIAN al emitirla. | Según el documento que elijas, el formulario cambia un poco: 1. **Invoice:** aparece el campo **Tasa de impuesto**, donde defines tú el porcentaje. 2. **Documentos con validez fiscal de Chile:** aparece el campo **Forma de pago** (Contado, Crédito o Sin costo) y el sistema calcula el impuesto automáticamente. 3. **Factura exenta y factura de exportación (Chile):** el interruptor **Exento** de cada producto se activa solo y no se puede desactivar, porque estos documentos no llevan impuestos. ## Estados de una factura En **Facturación → Facturas** puedes ver todas tus facturas o filtrarlas con las pestañas **Borradores**, **Por cobrar**, **Vencidas** y **Pagadas**. Cada factura muestra su estado: | Estado | Qué significa | Qué puedes hacer | | :- | :- | :- | | **Borrador** | La factura todavía no se emite. | Terminarla y crearla, o eliminar el borrador. | | **Pendiente de pago** | La factura está emitida y su vencimiento todavía no llega. | Enviarla a tu cliente o revisar su pago asociado. | | **Vencido** | Pasó la fecha de vencimiento y tu cliente no ha pagado. | Volver a enviarla o marcarla como incobrable. | | **Pagado** | El pago de la factura se recibió. | Nada, la factura está lista. | | **Incobrable** | La marcaste como incobrable. Ya no se envían recordatorios, pero tu cliente todavía puede pagarla. | Marcarla como cobrable si tu cliente decide pagar. | | **Tiene nota de crédito** | La factura se anuló en todo o en parte con una nota de crédito. En su detalle verás el **Total ajustado** y el enlace a la nota de crédito. | Revisar la nota de crédito desde el detalle de la factura. | Las facturas con un ícono de flechas circulares junto al estado se generaron automáticamente desde una suscripción. ## Paso a paso ### Crear una factura única **1. Abre el formulario** Ve a **Facturación → Facturas**, haz clic en **Nuevo** y elige **Factura única**. **2. Elige el cliente** Haz clic en **Seleccionar un cliente** y búscalo escribiendo su nombre. Una vez elegido, verás su nombre y su moneda. Si te equivocaste, haz clic en **Cambiar...**. **3. Completa los datos del documento** 1. **Tipo de factura:** elige el documento que vas a emitir (revisa **Tipos de documento** más arriba). 2. **Forma de pago:** aparece en los documentos con validez fiscal de Chile. Elige la que acordaste con tu cliente: **Contado**, **Crédito** o **Sin costo**. Es un dato que se informa al SII en el documento y no cambia nada en Piriod. Por ejemplo, elegir **Contado** no marca la factura como pagada: el pago se gestiona igual que con cualquier otra forma de pago. 3. **Fecha:** la fecha de emisión. Viene por defecto con la fecha de hoy. ![Facturas Datos Documento 1](https://mintcdn.com/piriod-d406ac55/rR5XCEdokoWMzd73/images/facturas-datos-documento-1.png?fit=max\&auto=format\&n=rR5XCEdokoWMzd73\&q=85\&s=f96b68eaa798d32dd1858ebcb465f9cb) **4. Agrega los productos** Puedes agregar cada línea de dos formas: 1. **A mano:** escribe el nombre, una descripción opcional, la **Cantidad**, la **Unidad** y el **Precio**. Activa **Exento** si esa línea no lleva impuesto. 2. **Desde tu catálogo:** haz clic en **Agregar un precio** y elige un producto o plan que ya tengas creado. Los datos se completan solos. Para sumar más líneas, haz clic en **Agregar un producto**. En cada línea también puedes agregar un **Código** y un **Descuento**, ambos opcionales. Si quieres aplicar un descuento a toda la factura, usa el campo **Descuento** de los totales (en porcentaje o monto). > [!WARNING] > > **Evita los caracteres especiales en documentos tributarios de Chile.** El SII puede rechazar facturas que tengan tildes, ñ, símbolos (como / \_ ? ' & ") o guiones largos. Escribe sin ellos el nombre y la descripción de los productos, el comentario y las descripciones de las referencias. Por ejemplo, "Reparacion de vehiculo" en lugar de "Reparación de vehículo". > [!NOTE] > > **En Chile, el precio se ingresa distinto en facturas y boletas.** > > 1. En una **factura electrónica**, el precio que ingresas es **neto** y el IVA se suma encima. Por ejemplo, un precio de 10.000 queda en un total de 11.900. > 2. En una **boleta electrónica**, el precio que ingresas ya **incluye el IVA** y el sistema lo desglosa. Por ejemplo, un precio de 10.000 queda en un total de 10.000 (8.403 neto y 1.597 de IVA). **5. Define cómo se va a pagar** En la sección **Pago**, elige una opción: 1. **Pago a través del portal de pagos por el total de la factura:** tu cliente paga en línea. En **Fecha de vencimiento** indica en cuántos días vence (vienen 30 por defecto) y verás debajo la fecha exacta de pago. 2. **Hacer un cargo a una tarjeta de crédito / débito del cliente:** cobra el total a una tarjeta que tu cliente ya registró (revisa [Tarjetas](/guia/ingresos/tarjetas)). > [!TIP] > > También puedes cobrar la factura a una tarjeta después de emitirla. Crea la factura con la opción de pago por el portal, abre el **Pago de factura** que se genera y haz clic en **Cargar a una tarjeta** (revisa [Pagos](/guia/ingresos/pagos/pagos)). **6. Agrega información adicional (opcional)** En **Información adicional** puedes completar: 1. **Periodo de facturación (desde y hasta) y Comentario:** aparecen en la glosa de la factura. 2. **Referencias:** documentos relacionados con la factura. Para cada una indicas la **Fecha**, el **Documento** (por ejemplo, Orden de compra, Guía de despacho, Contrato, Cotización o HES), el **Identificador** y una **Descripción**. > [!WARNING] > > Te recomendamos usar **máximo 10 productos y 5 referencias por factura**. Si pasas ese límite, el texto del PDF puede quedar encima del pie del documento. **7. Crea la factura** Mientras completas el formulario, Piriod guarda un borrador automáticamente (verás **Borrador guardado hace unos segundos**). Si quieres terminar después, haz clic en **Guardar y salir**; si ya no la necesitas, haz clic en **Eliminar borrador**. Cuando todo esté listo, haz clic en **Crear factura** y luego en **Continuar** en la ventana **Confirmar documento**. > [!WARNING] > > Esta acción no se puede deshacer. Una vez emitida, la factura no se puede editar. Si necesitas corregirla o anularla, tienes que crear una nota de crédito (revisa [Notas de crédito](/guia/facturacion/notas-de-credito)). ### Enviar la factura a tu cliente Cuando creas una factura desde el panel, **no se envía sola**. Tienes que enviarla tú: **1. Abre la factura** Entra al detalle de la factura que quieres enviar y haz clic en **Enviar factura**. **2. Completa el email** 1. **Para:** elige a quién se enviará. Aparecen el email de facturación del cliente y sus contactos con notificaciones activas. 2. **Asunto:** escribe el asunto del correo. 3. **Elegir una plantilla:** si tienes plantillas creadas, puedes usar una. 4. **Botón de pago:** actívalo si quieres que el email incluya el botón **Pagar**. Depende de los medios de pago que tengas conectados. El email siempre incluye la factura en **PDF**. En los documentos con validez fiscal, también adjunta el archivo de formato local. Puedes verlos en **Archivos adjuntos**, al final de la vista previa. ![Facturas Enviar Email 1](https://mintcdn.com/piriod-d406ac55/rR5XCEdokoWMzd73/images/facturas-enviar-email-1.png?fit=max\&auto=format\&n=rR5XCEdokoWMzd73\&q=85\&s=9e9d04825ed32bdad33ba192aae35f3c) **3. Envía el email** Haz clic en **Enviar**. En el detalle de la factura aparecerá el aviso **La factura fue enviada a** con el email y la hora del envío. ## Qué pasa después Al emitir la factura, se abre su detalle. Esto es lo que encuentras: 1. **Encabezado:** el total, el cliente, la fecha y el estado del pago (por ejemplo, **Pendiente**). 2. **Información general:** el tipo de factura, el número, el ID (empieza con `inv_`) y la fecha de creación. Si la factura viene de una suscripción, también verás el enlace a esa suscripción. 3. **Información de cobranza:** la fecha de vencimiento y el periodo de facturación. 4. **Estado ante la autoridad fiscal:** en Chile verás la sección **Gestión Servicio de Impuestos Internos** y en Brasil la sección **Gestión NFE.io**, con el estado del documento y sus datos de envío. En México esta sección no aparece. Tampoco aparece en el Invoice y el Recibo, porque no se envían a ninguna autoridad fiscal. 5. **Pagos:** Piriod crea automáticamente un pago asociado llamado **Pago de factura**, con el mismo monto y vencimiento (revisa [Pagos](/guia/ingresos/pagos/pagos)). 6. **Productos:** las líneas de la factura con sus totales. ![Facturas Detalle Emitida 1](https://mintcdn.com/piriod-d406ac55/rR5XCEdokoWMzd73/images/facturas-detalle-emitida-1.png?fit=max\&auto=format\&n=rR5XCEdokoWMzd73\&q=85\&s=1a6eef8d46e79cfab91e5bf8abb11fc0) ### Acciones disponibles | Acción | Dónde está | Qué hace | | :- | :- | :- | | **Enviar factura** | Botón superior | Envía la factura por email con el PDF (y el archivo de formato local en documentos con validez fiscal) y, si lo activas, el botón de pago. | | **PDF** | Botón superior | Muestra la factura y te permite descargarla con **Descargar PDF**. | | **Duplicar** | Menú **Más** | Crea un borrador con los mismos datos de la factura, listo para que lo revises y lo emitas. | | **Marcar como incobrable** | Menú **Más** | La factura deja de considerarse en la cobranza (ya no se envían recordatorios de pago), pero el pago sigue pendiente y tu cliente todavía puede pagarla. | | **Marcar como cobrable** | Menú **Más** | Aparece en facturas incobrables. La vuelve a incluir en la cobranza, por ejemplo, si tu cliente decide pagar. | | **Crear nota de crédito** | Menú **Más** | Corrige o anula la factura. | ## Problemas frecuentes > **No me aparece el tipo de documento que necesito** > > **Por qué pasa:** en la lista **Tipo de factura** solo aparecen los documentos que tu empresa tiene habilitados. > > **Cómo resolverlo:** si necesitas emitir un documento que no aparece, escríbenos a soporte para revisar la configuración de tu empresa. > **El campo Tipo de factura aparece en rojo al elegir Factura electrónica de exportación** > > **Por qué pasa:** el cliente tiene como moneda CLP (peso chileno). La factura de exportación solo se puede emitir a clientes con otra moneda. > > **Cómo resolverlo:** > > 1. Si el cliente es extranjero, cambia su moneda en su ficha y vuelve a crear la factura. > 2. Si el cliente es nacional, elige otro tipo de documento. > **El total de la boleta no es el que esperaba** > > **Por qué pasa:** en la boleta electrónica, el precio que ingresas ya incluye el IVA. En la factura electrónica, en cambio, el IVA se suma al precio. > > **Cómo resolverlo:** si quieres cobrar un total exacto en una boleta, ingresa ese total como precio. Si trabajas con precios netos, calcula el precio con IVA antes de ingresarlo. > **Un producto de mi catálogo aparece con precio 0** > > **Por qué pasa:** es un plan por consumo o por volumen. Su precio depende del uso, por eso se carga en 0. > > **Cómo resolverlo:** ingresa a mano el precio que corresponde cobrar antes de crear la factura. > **El precio de un producto no coincide con la moneda del cliente** > > **Por qué pasa:** al agregar un producto desde tu catálogo, su precio se carga tal como lo creaste, en su moneda original. Si esa moneda es distinta a la del cliente, el valor no coincide. Por ejemplo, un plan de 1 UF se carga como 1 peso si el cliente está en CLP. > > **Cómo resolverlo:** antes de crear la factura, ajusta el precio a mano en la moneda del cliente (en el ejemplo, el valor de la UF del día en pesos). > **Mi cliente no recibió la factura** > > **Por qué pasa:** las facturas creadas desde el panel no se envían solas. > > **Cómo resolverlo:** > > 1. Abre la factura y revisa si aparece el aviso **La factura fue enviada a**. > 2. Si no aparece, haz clic en **Enviar factura** y envíala. > 3. Si ya se envió, confirma con tu cliente que el email sea correcto y pídele que revise su carpeta de spam. > **El email de la factura no tiene el botón Pagar** > > **Por qué pasa:** el interruptor **Botón de pago** estaba desactivado al enviar, o no tienes medios de pago conectados. > > **Cómo resolverlo:** vuelve a enviar la factura con **Botón de pago** activado. Si no puedes activarlo, conecta un medio de pago (revisa [Procesadores de pago](/guia/integraciones/procesadores-de-pago/procesadores-de-pago)). > **El texto del PDF se superpone con el pie del documento** > > **Por qué pasa:** la factura tiene más de 10 productos o más de 5 referencias. > > **Cómo resolverlo:** si la factura ya está emitida, crea una nota de crédito y emite nuevas facturas repartiendo los productos o las referencias. > **Me equivoqué en una factura que ya emití** > > **Por qué pasa:** una factura emitida no se puede editar ni eliminar. > > **Cómo resolverlo:** en el detalle de la factura, haz clic en **Más → Crear nota de crédito** para corregirla o anularla. Luego, si corresponde, crea una nueva factura con los datos correctos (puedes usar **Duplicar** para no empezar desde cero). > [!TIP] > > ¿Tienes una duda que no aparece aquí? Escríbenos a soporte e incluye el ID de la factura (lo encuentras en **Información general** y empieza con `inv_`). Así podemos ayudarte más rápido. ## Siguientes pasos > **[Pagos](/guia/ingresos/pagos/pagos)** > > Revisa y gestiona el pago asociado a tu factura. > **[Notas de crédito](/guia/facturacion/notas-de-credito)** > > Corrige o anula una factura emitida. > **[Facturas recurrentes](/guia/suscripciones/facturas-recurrentes)** > > Automatiza los cobros que se repiten cada mes. > **[Tarjetas](/guia/ingresos/tarjetas)** > > Pide a tu cliente que registre su tarjeta para cobrarle directamente. # Notas De Crédito Source: https://docs.piriod.com/guia/facturacion/notas-de-credito Anula o corrige una factura emitida, reembolsa su pago y anula una nota de crédito con una nota de débito. Una nota de crédito es el documento con el que anulas o corriges una factura que ya emitiste. En Piriod la creas desde la misma factura, y el sistema ajusta el total de la factura y su pago asociado por ti. ## Para qué te sirve Una factura emitida no se puede editar ni eliminar. Con una nota de crédito puedes: 1. **Anular la factura completa.** 2. **Anular solo una parte,** quitando productos o rebajando su valor. 3. **Corregir datos que no afectan el monto,** como la dirección o el giro, con una nota de crédito administrativa. Funciona igual para todos los documentos que emites en Piriod: facturas, boletas, Invoice y Recibo. En este artículo también te explicamos cómo reembolsar un pago que cobraste a una tarjeta registrada y cómo anular una nota de crédito con una nota de débito. ## Antes de empezar 1. **La factura debe estar emitida.** Los borradores no necesitan nota de crédito: puedes editarlos o eliminarlos. 2. **La nota de crédito siempre se crea desde una factura.** Toma su cliente, su moneda y sus productos. Si la factura tiene validez fiscal, la nota de crédito también la tiene y se envía automáticamente a la autoridad fiscal. 3. **Si cobraste la factura con un cargo a una tarjeta que tu cliente tiene registrada en Piriod y vas a devolverle el dinero, haz el reembolso antes de crear la nota de crédito** (revisa **Reembolsar un pago** más abajo). Es el único caso en que el reembolso se hace desde Piriod. En cualquier otro, puedes crear la nota de crédito directamente y gestionar el reembolso por fuera. 4. **Una nota de crédito emitida no se puede editar ni eliminar.** Solo se puede anular completa con una nota de débito. ## Tipos de nota de crédito El formulario es el mismo en todos los casos. Lo que cambia es lo que haces con los productos que trae cargados: | Tipo | Qué haces en el formulario | Cómo queda la factura | | :- | :- | :- | | **Anulación total** | Dejas los productos tal como vienen. | El total ajustado queda en 0. | | **Anulación parcial por producto** | Dejas solo los productos que quieres anular y quitas el resto con la **X**. | El total ajustado es el valor de los productos que quitaste de la nota. | | **Anulación parcial por valor** | Cambias la **Cantidad** o el **Precio** para dejar solo el monto que quieres anular. | El total ajustado es la diferencia entre el total original y el monto anulado. | | **Administrativa** | Reemplazas los productos por una línea con precio 0. | El total no cambia. Solo se corrige un dato. | ## Paso a paso ### Crear una nota de crédito **1. Abre la factura** Ve a **Facturación → Facturas** y entra al detalle de la factura que quieres anular o corregir. **2. Abre el formulario** Haz clic en **Más** y elige **Crear nota de crédito**. El formulario se abre con todos los productos de la factura. **3. Ajusta los productos** En **Ítems de crédito** deja solo lo que quieres anular: 1. **Para anular la factura completa,** no cambies nada. 2. **Para anular solo algunos productos,** quita con la **X** los que no quieres anular. 3. **Para anular solo una parte del valor,** cambia la **Cantidad** o el **Precio** de la línea. También puedes sumar una línea con **Agregar un ítem de crédito** o aplicar un **Descuento**. Si quieres volver a empezar, haz clic en **Restablecer valores**. Mientras ajustas, el formulario te muestra el **Total de la nota de crédito**, el **Total de la factura** y el **Total de la factura ajustada**, que es lo que tu cliente tendrá que pagar una vez emitida la nota. ![Nc Formulario](https://mintcdn.com/piriod-d406ac55/x3rvvQxy5ICWjKRf/images/nc-formulario.png?fit=max\&auto=format\&n=x3rvvQxy5ICWjKRf\&q=85\&s=a3f2954ef61b0f78e9e58c7079471e52) **4. Completa la fecha y la razón** 1. **Fecha:** la fecha de emisión de la nota de crédito. 2. **Razón de la anulación:** explica por qué anulas o corriges la factura. Tu cliente verá este texto en el documento. 3. **Nota interna (opcional):** un comentario para tu equipo. Tu cliente no la ve. > [!WARNING] > > **Evita los caracteres especiales en documentos tributarios de Chile.** Escribe la razón de la anulación y los nombres de los productos sin tildes, ñ ni símbolos, porque el SII puede rechazar el documento. Por ejemplo, "Anulacion por error en el monto". **5. Crea la nota de crédito** Haz clic en **Crear nota de crédito**. Aparece una ventana que te indica cómo quedará el total de la factura. Revísala y confirma con **Crear nota de crédito**. > [!WARNING] > > Esta acción no se puede deshacer. Si te equivocas, tendrás que anular la nota de crédito con una nota de débito. ### Crear una nota de crédito administrativa Sirve para corregir datos que no cambian el monto de la factura: la **dirección**, la **comuna**, el **giro** o la **glosa**. Se emite con valor 0: **1. Abre el formulario** En el detalle de la factura, haz clic en **Más → Crear nota de crédito**. **2. Agrega una línea con precio 0** Haz clic en **Agregar un ítem de crédito**. Escribe `NC administrativa` como nombre, detalla la corrección en la descripción e ingresa `0` en el precio. **3. Quita los productos originales** Elimina con la **X** todos los productos que venían de la factura, para que el total de la nota de crédito quede en 0. **4. Crea la nota de crédito** Escribe `NC Administrativa` en **Razón de la anulación**, haz clic en **Crear nota de crédito** y confirma. > [!WARNING] > > **El RUT y la razón social no se pueden corregir con una nota de crédito administrativa.** Si alguno de esos datos quedó mal, anula la factura con una nota de crédito por el total y emite una nueva con los datos correctos. ### Reembolsar un pago Este paso es opcional y aplica en un solo caso: cuando cobraste la factura con un **cargo a una tarjeta registrada en Piriod** (a través de Webpay One Click o Getnet Click) y quieres devolver ese dinero desde la plataforma. No importa si el cargo lo hiciste tú desde el panel o si fue automático desde una suscripción. En cualquier otro caso, no necesitas pasar por aquí: crea la nota de crédito directamente. Piriod no te pide un reembolso para emitirla. > [!WARNING] > > **Si vas a reembolsar desde Piriod, hazlo antes de la nota de crédito.** El orden es: factura, pago, reembolso y nota de crédito. La nota de crédito cierra el ciclo de la factura, así que una vez emitida, el botón **Reembolsar** deja de estar disponible. **1. Abre el pago** Ve a **Ingresos → Pagos** y entra al detalle del pago. También puedes llegar desde la factura, en la sección **Pagos**. **2. Inicia el reembolso** En la sección **Transacciones**, haz clic en **Reembolsar**. Se abre la ventana **Reembolsar pago**. **3. Completa el formulario** 1. **Monto:** escribe el monto que vas a devolver. Puede ser el total del pago o solo una parte. 2. **Razón del reembolso:** elige una opción de la lista: **Duplicado**, **Fraudulento** o **Solicitado por el cliente**. 3. **Detalle (opcional):** en el cuadro de texto puedes agregar un comentario. ![Formulario Reembolso 1](https://mintcdn.com/piriod-d406ac55/czUL3ZUh_hWblYsf/images/formulario-reembolso-1.png?fit=max\&auto=format\&n=czUL3ZUh_hWblYsf\&q=85\&s=0ab1385de927a257c312b826670d0ac6) **4. Confirma** Haz clic en **Reembolsar** y luego en **Continuar** en la ventana de confirmación. El dinero vuelve a la misma tarjeta con la que se hizo el cargo. > [!WARNING] > > Esta acción no se puede deshacer. **5. Revisa el pago** El estado del pago cambia a **Reembolso total** o **Reembolso parcial**, según el monto que devolviste, y aparece la sección **Reembolsos**, con el monto devuelto, la razón y la fecha. ![Reembolso Total](https://mintcdn.com/piriod-d406ac55/x3rvvQxy5ICWjKRf/images/reembolso-total.png?fit=max\&auto=format\&n=x3rvvQxy5ICWjKRf\&q=85\&s=9a1cc45c5687370aaec2a1850f785343) **6. Crea la nota de crédito** Con el reembolso hecho, vuelve a la factura y crea la nota de crédito por el mismo monto. Hasta ese momento la factura sigue en estado **Pagado**, porque el reembolso devuelve el dinero pero no modifica el documento: es la nota de crédito la que ajusta su total. > [!NOTE] > > Solo puedes hacer **un reembolso por pago**, sea total o parcial. Los plazos y las condiciones dependen de cada procesador: revísalos en [Webpay One Click](/guia/integraciones/procesadores-de-pago/webpay-one-click#reembolsos-reversas-y-anulaciones) o [Getnet](/guia/integraciones/procesadores-de-pago/getnet#reembolsos-anulaciones-y-devoluciones). ### Enviar la nota de crédito a tu cliente Igual que las facturas creadas desde el panel, la nota de crédito **no se envía sola**: **1. Abre la nota de crédito** Entra a su detalle desde **Facturación → Notas de crédito** o desde el enlace que aparece en la factura, y haz clic en **Enviar nota de crédito**. **2. Completa el email** Elige los destinatarios en **Para** y escribe el **Asunto**. El email siempre incluye la nota de crédito en **PDF**. En los documentos con validez fiscal, también adjunta el archivo de formato local. **3. Envía el email** Haz clic en **Enviar**. En el detalle aparecerá el aviso **La nota de crédito fue enviada a**, con el email y la hora del envío. ### Anular una nota de crédito con una nota de débito Una nota de crédito emitida solo se puede anular con una nota de débito. En Piriod, la nota de débito anula la nota de crédito **completa**: **1. Abre la nota de crédito** Puedes llegar de dos formas: 1. **Desde el listado:** ve a **Facturación → Notas de crédito** y entra al detalle de la nota que quieres anular. 2. **Desde la factura:** abre la factura y haz clic en el enlace de la nota de crédito, que aparece en el aviso superior y en la sección **Productos**. **2. Abre el formulario** Haz clic en **Nota de débito**. **3. Completa los datos** Indica la **Fecha** y la **Razón de la anulación**. Si quieres, agrega una **Nota interna**. **4. Crea la nota de débito** Confirma la emisión. El monto de la nota de crédito vuelve a sumarse a la factura. Si lo que necesitas es cambiar el monto de una nota de crédito, anúlala con una nota de débito y luego crea una nota de crédito nueva desde la factura. ## Qué pasa después ### En la nota de crédito Al emitirla, se abre su detalle. Esto es lo que encuentras: 1. **Encabezado:** el total, el cliente, el enlace a la factura que anula y la fecha. 2. **Información general:** la razón, el ID (empieza con `cre_`), quién la creó, cuándo y la nota interna. 3. **Agencia fiscal:** aparece en los documentos con validez fiscal, con el estado del envío y sus datos. No aparece cuando la nota anula un Invoice o un Recibo. 4. **Botones:** **Enviar nota de crédito**, **PDF** y **Nota de débito**. ![Nc Emitida](https://mintcdn.com/piriod-d406ac55/x3rvvQxy5ICWjKRf/images/nc-emitida.png?fit=max\&auto=format\&n=x3rvvQxy5ICWjKRf\&q=85\&s=0260998669d047a362962d42cf133ed6) ### En la factura y su pago La factura queda con la etiqueta **Tiene nota de crédito** y en su detalle verás: 1. **El aviso de la nota de crédito,** con su número, su razón y un enlace para abrirla. 2. **El Total ajustado** junto al total original. Es el total de la factura menos el total de sus notas de crédito, y representa el valor real a pagar. 3. **En Productos,** el enlace a cada nota de crédito, el **Total créditos** y el **Total factura ajustada**. Si hay una nota de débito, también verás su enlace y el **Total débitos**. El pago asociado se ajusta solo: | Caso | Total ajustado de la factura | Pago asociado | | :- | :- | :- | | **Anulación total** | 0 | Queda **Cancelado**. | | **Anulación parcial** | El saldo que queda por pagar | Sigue **Pendiente**, con el monto ajustado. Tu cliente verá ese monto en la página de pago. | | **Nota de crédito anulada con nota de débito** | Vuelve a sumar el monto de la nota de crédito | Sigue **Pendiente**, con el nuevo monto. | Si reembolsaste el pago antes de anular la factura completa, el pago pasa de **Reembolso total** a **Cancelado** al emitir la nota de crédito. Una factura puede tener más de una nota de crédito. El total ajustado siempre considera todas. ![Nc Parcial](https://mintcdn.com/piriod-d406ac55/WB3pG1koafHd-_H8/images/nc-parcial.png?fit=max\&auto=format\&n=WB3pG1koafHd-_H8\&q=85\&s=97be9ee20deca9afe99bb73c40da25f6) ### En el listado En **Facturación → Notas de crédito** ves todas tus notas con su cliente, el documento, la fecha, la factura que anulan (columna **Anulación**) y el total. Cada una muestra su estado: | Estado | Qué significa | | :- | :- | | **Emitido** | La nota de crédito está vigente. | | **Tiene nota de débito** | La nota de crédito se anuló con una nota de débito. | Las notas de débito se consultan desde la nota de crédito que anulan, donde queda un aviso con su número y su razón, o desde la factura original, en la sección **Productos**. ![Lista Nc](https://mintcdn.com/piriod-d406ac55/x3rvvQxy5ICWjKRf/images/lista-nc.png?fit=max\&auto=format\&n=x3rvvQxy5ICWjKRf\&q=85\&s=92491a09ff7fc4b6cfc7011ef5b9f4d4) ## Problemas frecuentes > **No me aparece el botón Reembolsar** > > **Por qué pasa:** hay dos motivos posibles. > > 1. El pago no se hizo con un cargo a una tarjeta registrada en Piriod (Webpay One Click o Getnet Click). Por ejemplo, tu cliente pagó desde la página de pago o por transferencia. > 2. La factura ya tiene una nota de crédito. El reembolso solo está disponible antes de emitirla. > > **Cómo resolverlo:** en el primer caso no hay nada que corregir: el reembolso desde Piriod no aplica y puedes crear la nota de crédito directamente. En el segundo, si todavía tienes que devolver el dinero, gestiona la devolución con tu cliente fuera de Piriod. > **Reembolsé el pago y la factura sigue como Pagada** > > **Por qué pasa:** el reembolso devuelve el dinero, pero no cambia la factura. El estado del reembolso se ve en el detalle del pago, y la factura se ajusta recién con la nota de crédito. > > **Cómo resolverlo:** crea la nota de crédito desde la factura por el mismo monto que reembolsaste. > **Emití la nota de crédito por un monto equivocado** > > **Por qué pasa:** una nota de crédito emitida no se puede editar. > > **Cómo resolverlo:** > > 1. Abre la nota de crédito y anúlala con **Nota de débito**. > 2. Vuelve a la factura y crea una nota de crédito nueva con el monto correcto. > **Quiero anular solo una parte de una nota de crédito** > > **Por qué pasa:** en Piriod, la nota de débito anula la nota de crédito completa. > > **Cómo resolverlo:** anula la nota de crédito con una nota de débito y crea una nueva por el monto que corresponde. > **El pago sigue pendiente después de crear la nota de crédito** > > **Por qué pasa:** la nota de crédito anuló solo una parte de la factura, así que queda un saldo por pagar. > > **Cómo resolverlo:** revisa el **Total ajustado** en la factura. Si tu intención era anularla completa, crea otra nota de crédito por el saldo. > **Ya no me aparece el botón Nota de débito** > > **Por qué pasa:** la nota de crédito ya tiene una nota de débito. Cada nota de crédito se puede anular una sola vez. > > **Cómo resolverlo:** si necesitas volver a rebajar la factura, crea una nota de crédito nueva desde la factura. > **No encuentro una nota de débito** > > **Por qué pasa:** las notas de débito no tienen un listado propio. > > **Cómo resolverlo:** en **Facturación → Notas de crédito**, busca la nota con la etiqueta **Tiene nota de débito** y ábrela. También puedes verla en la factura original, en la sección **Productos**. > **Mi cliente no recibió la nota de crédito** > > **Por qué pasa:** la nota de crédito no se envía sola. > > **Cómo resolverlo:** abre la nota de crédito y haz clic en **Enviar nota de crédito**. Si ya aparece el aviso de envío, confirma el email con tu cliente y pídele que revise su carpeta de spam. > **Emití la factura con el RUT o la razón social equivocados** > > **Por qué pasa:** esos datos no se pueden corregir con una nota de crédito administrativa, que solo permite cambiar la dirección, la comuna, el giro o la glosa.\ > **Cómo resolverlo:** > > 1. Anula la factura con una nota de crédito por el total. > 2. Corrige los datos del cliente en su ficha. > 3. Crea una factura nueva. > [!TIP] > > ¿Tienes una duda que no aparece aquí? Escríbenos a soporte e incluye el ID de la nota de crédito (lo encuentras en **Información general** y empieza con `cre_`). Así podemos ayudarte más rápido. ## Siguientes pasos > **[Facturas](/guia/facturacion/facturas)** > > Crea una factura nueva con los datos correctos. > **[Pagos](/guia/ingresos/pagos/pagos)** > > Revisa el pago asociado a tu factura. > **[Webpay One Click](/guia/integraciones/procesadores-de-pago/webpay-one-click)** > > Conoce los plazos y condiciones de los reembolsos. > **[Getnet](/guia/integraciones/procesadores-de-pago/getnet)** > > Conoce los plazos y condiciones de los reembolsos. # Ordenes Source: https://docs.piriod.com/guia/facturacion/ordenes Las órdenes son documentos que respaldan el traslado de mercancía o productos — ya sea por venta, despacho, traslado interno entre sucursales, entrega gratuita u otros tipos de envío. *** ### Crear una orden Ve a **Facturación → Órdenes → Nuevo** ![Captura De Pantalla 2026 04 30 A La(s) 14 30 06](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-14.30.06.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=3ad2496b3b1c66b629634700c31f6a7b) 1. Selecciona el cliente 2. Selecciona el tipo de documento: * **Order** — para órdenes estándar * **Guía de despacho electrónica** — para Chile, requiere aprobación del SII 3. Completa los datos del despacho: | Campo | Requerido | | :- | :- | | Tipo de envío | Sí | | Dirección de envío | Sí | | País | Sí | | Estado/región | Sí | | Nombre del conductor | No | | ID del conductor | No | | Patente del transporte | No | | Comentario adicional | No | 4. Agrega los productos a transportar — puedes incluir más de uno 5. Si corresponde, agrega las referencias necesarias 6. Haz clic en **Crear orden** Una vez creada, puedes enviarla por email a los contactos asociados al cliente y descargar o visualizar el PDF. ![Captura De Pantalla 2026 04 30 A La(s) 14 31 28](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-14.31.28.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=fc58b16bf11bdd02fcf1c2abadf88e34) *** ### Tipos de despacho | Tipo | API ID | | :- | :- | | Operación constituye venta | `1` | | Ventas por efectuar | `2` | | Consignaciones | `3` | | Entrega gratuita | `4` | | Traslados internos | `5` | | Otros traslados no venta | `6` | | Guía de devolución | `7` | | Traslado para exportación (no venta) | `8` | | Venta para exportación | `9` | # Cuentas Por Cobrar Source: https://docs.piriod.com/guia/ingresos/cuentas-por-cobrar Cuentas por cobrar centraliza el seguimiento de tu deuda pendiente. Desde el panel principal puedes ver el monto vencido, el monto por vencer y el total de la deuda, identificar tus principales deudores y revisar la antigüedad de las facturas pendientes. Ve a **Ingresos → Cuentas por cobrar**. ![Image (24)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(24\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=bdba2b705600768e1e4ee0064f1f6c9e) *** ### Recordatorios automáticos Piriod puede enviar emails de cobranza automáticamente según las reglas que configures — antes o después del vencimiento de cada factura. Para configurarlos ve a **Reglas de envío de recordatorios** desde el panel principal. ![Captura De Pantalla 2026 04 30 A La(s) 18 10 13](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-18.10.13.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=02070a70f892621065cb267472f97e99) #### Crear una regla 1. Haz clic en **+** para agregar una nueva regla 2. Define la programación del envío — cuántos días antes o después del vencimiento se enviará el email 3. Escribe el asunto del email 4. Redacta el mensaje usando las variables disponibles en **Insertar variable**: * `Número de factura` * `Tipo de factura` * `Fecha de la factura` * `Fecha de vencimiento del pago` * `Monto total` * `Nombre del cliente` 5. Haz clic en **Guardar** ![Image (30)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(30\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=e93b6c0fbbd1b946eafd2d0e4e52305d) > [!NOTE] > > Puedes crear y guardar hasta **5 reglas** de recordatorio. #### Activar los recordatorios Una vez creada al menos una regla, activa el interruptor **Activar los recordatorios automáticos** en la esquina superior derecha. Puedes desactivarlo en cualquier momento si necesitas pausar los envíos. ![Image (31)](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/image-\(31\).png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=bb2585851b1a5d1ca5781277507877da) *** ### Recordatorios enviados Desde **Ingresos → Cuentas por cobrar → Recordatorios enviados** puedes revisar el historial completo de emails enviados. Filtra por nombre de cliente, fecha de envío, número de factura y otras opciones disponibles. *** ### Cargos automáticos Próximamente. # Pagos Externos Source: https://docs.piriod.com/guia/ingresos/pagos-externos Los pagos externos permiten registrar cobros realizados fuera de los medios conectados en Piriod — como efectivo, cheques o transferencias bancarias manuales. Una vez registrado, el pago queda marcado como pagado y la factura asociada se actualiza automáticamente. *** ### Registrar un pago externo 1. Ve a **Ingresos → Pagos** y abre el detalle del pago 2. Haz clic en **Agregar pago externo** 3. Completa los datos en el formulario: * **Monto** — puedes registrar un pago parcial; el saldo pendiente se actualizará en tiempo real * **Medio de pago** — efectivo, cheque, transferencia bancaria, entre otros * **Fecha de pago** * **Nota interna** — campo opcional para agregar detalles como número de cheque u otra referencia 4. Haz clic en **Crear pago externo** ![Captura De Pantalla 2026 04 30 A La(s) 17 32 17](https://mintcdn.com/piriod-d406ac55/CyasDKczYvaYYs01/images/Captura-de-pantalla-2026-04-30-a-la\(s\)-17.32.17.png?fit=max\&auto=format\&n=CyasDKczYvaYYs01\&q=85\&s=83a510e995f8677ad84ad115d347934c) > [!NOTE] > > Esta opción solo está disponible para pagos en estado **incompleto** o **pendiente**. # Comprobante De Pago Source: https://docs.piriod.com/guia/ingresos/pagos/comprobante-de-pago El comprobante de pago es el documento fiscal requerido por el SAT cuando una factura es pagada en una fecha posterior a su emisión. > [!NOTE] > > Esta funcionalidad está disponible solo para México ### **Condiciones para la generación de comprobantes de pago** La acción estará disponible solo cuando: * La organización esté configurada en **México** * El pago de la factura esté registrado como **pagado** * El pago esté asociado a un **comprobante de ingreso** > Si estas condiciones no se cumplen, la opción no se visualizará. ### **Cómo generar el comprobante** 1. Abrir el detalle del pago correspondiente, tienes 2 formas: 1. desde la lista de pagos 2. desde el detalle de la factura, sección pagos 2. En la parte superior derecha, haz clic en **“Generar comprobante SAT”** 3. Confirmar la acción > Piriod emitirá el documento ante el SAT y lo dejará disponible inmediatamente. ### **Cómo ver o descargar el PDF** Una vez emitido: * El botón cambiará a **“Ver PDF”** * Al hacer clic, se abrirá la vista previa del comprobante * Desde ahí podrás **descargar el archivo** si lo necesitas ### **¿No ves la acción Comprobante SAT?** Revisa que: * El pago esté efectivamente marcado como pagado * La factura asociada sea de México * El pago esté vinculado a una factura > Si todo está correcto y aún no aparece, contacta a soporte. # Pagos Source: https://docs.piriod.com/guia/ingresos/pagos/pagos Revisa, cobra y gestiona los pagos asociados a tus facturas. Cada vez que emites una factura, Piriod crea un pago asociado para registrar el cobro. Desde **Ingresos → Pagos** puedes ver en qué estado está cada cobro, cobrarlo a una tarjeta o registrar un pago que recibiste por fuera. ## Para qué te sirve Los pagos te permiten saber en todo momento qué facturas ya están cobradas y cuáles siguen pendientes. Por ejemplo, si un cliente te dice que ya pagó, puedes abrir su pago y revisar el estado, el monto pendiente y la factura asociada antes de responderle. ## Cómo se crea un pago Casi siempre no tienes que crearlo tú. Piriod lo genera de estas formas: 1. **Desde una factura.** Cada vez que emites una factura, ya sea única, masiva o desde una suscripción, Piriod crea su pago automáticamente (revisa [Facturas](/guia/facturacion/facturas)). 2. **Desde el panel.** Cuando necesitas registrar un cobro sin factura (ver **Paso a paso** más abajo). 3. **Por API.** Si tu sistema se conecta con Piriod, puedes crearlos con el recurso [Create payment](/api-reference/payments/payments/create-payment). ## Estados de un pago | Estado | Qué significa | Qué puedes hacer | | :- | :- | :- | | **Pendiente** | El pago todavía no se ha realizado. Lo encuentras en la pestaña **Incompletos**. | Compartir el link de pago con tu cliente o cargarlo a una tarjeta registrada. | | **Procesando** | Tu cliente está pagando en este momento. | Esperar unos minutos a que termine. | | **Pagado** | El cobro se recibió correctamente. | Nada, el pago está listo. | | **Fallido** | El cargo a la tarjeta fue rechazado. El motivo aparece en un aviso amarillo en el detalle del pago. | Intentar el cobro de nuevo, con la misma u otra tarjeta, o enviar el link de pago. | | **Cancelado** | La factura se anuló con una nota de crédito. | Nada, el pago ya no se cobrará. | ## Cómo puede pagar tu cliente 1. **Cargo automático a tarjeta.** En las suscripciones, Piriod cobra cada ciclo a la tarjeta que registró tu cliente. 2. **Cargo a tarjeta desde el panel.** Tú haces el cobro manualmente a una tarjeta registrada. 3. **Página de pago.** Le compartes el link y tu cliente paga en línea con los medios de pago que tengas conectados. 4. **Transferencia bancaria.** Tu cliente te transfiere desde su banco. Si lo habilitas, tus datos bancarios aparecen en la página de pago para que los tenga a mano. Con tu banco conectado, Piriod detecta la transferencia y la asocia a la factura. 5. **Pago externo.** Registras un cobro que recibiste fuera de Piriod, como efectivo, cheque o depósito. > [!NOTE] > > En la página de pago solo aparecen los medios de pago que tienes conectados y que procesan la moneda en que se creó el pago. ## Paso a paso ### Crear un pago desde el panel **1. Abre la sección de pagos** Ve a **Ingresos → Pagos** y haz clic en **Nuevo**. **2. Completa la información** Completa los datos del pago: 1. **Moneda:** viene seleccionado el peso chileno; cámbiala si vas a cobrar en otra moneda. 2. **Monto:** el valor que vas a cobrar. 3. **Descripción:** un texto breve que te ayude a identificar el cobro (por ejemplo, "Pago por servicios"). 4. **Fecha de pago:** la fecha límite para pagar. Aparecerá como **Vencimiento** en el detalle del pago. 5. **Cliente:** despliega **Más opciones**, haz clic en **Seleccionar un cliente** y elige a quién le vas a cobrar. > [!WARNING] > > El cliente es opcional, pero te recomendamos elegirlo. Si creas el pago sin cliente, **no podrás asociarlo después**: quedará como **Cliente no especificado** incluso cuando se pague. Además, no podrás cobrarlo a una tarjeta; solo podrás compartir la página de pago o registrar un pago externo. ![Crear Pago](https://mintcdn.com/piriod-d406ac55/Mu45UkKBuJbVwU2M/images/crear-pago.png?fit=max\&auto=format\&n=Mu45UkKBuJbVwU2M\&q=85\&s=e52f2c37bb7540ecc5ed01fcbeea70b2) **3. Crea el pago** Haz clic en **Crear pago**. ### Cobrar un pago a una tarjeta Esta opción aparece solo en pagos **pendientes** o **fallidos**, porque son los que todavía no se han cobrado. Además, el pago debe tener un cliente asociado y ese cliente debe tener al menos una tarjeta registrada. **1. Abre el pago** Ve a **Ingresos → Pagos** y haz clic en el pago que quieres cobrar. **2. Elige cargar a una tarjeta** Haz clic en **Cargar a una tarjeta**. **3. Selecciona la tarjeta** Verás las tarjetas registradas de tu cliente, cada una con su marca, sus últimos 4 dígitos y el medio de pago con que se registró (por ejemplo, Webpay OneClick o Getnet Click). Elige la tarjeta y haz clic en **Cargar**. ![Seleccionar Tarjeta](https://mintcdn.com/piriod-d406ac55/Mu45UkKBuJbVwU2M/images/Seleccionar-tarjeta.png?fit=max\&auto=format\&n=Mu45UkKBuJbVwU2M\&q=85\&s=0482616fe39527697841010873ca3f51) **4. Confirma el cobro** Piriod te mostrará el monto que se cargará a la tarjeta. Revísalo y haz clic en **Continuar**. > [!WARNING] > > Esta acción no se puede deshacer. Antes de continuar, confirma que el monto y la tarjeta sean los correctos.