> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PSM publications

PSM publications are the corporate notices that companies publish in the Secretaría de Economía's Publicaciones de Sociedades Mercantiles (PSM) system, as the law requires: shareholder meeting calls, capital increases and reductions, mergers, spin-offs and transformations, liquidation balance sheets, SAS annual financial reports, and shareholder structure and beneficial owner notices. Use them to follow a company's corporate events and to read the original notices.

PSM data is collected by running a `psm` extraction. Syntage keeps a copy of the PSM portal that it updates throughout the day, and the extraction finds the publications filed under the entity's RFC or name in that copy. A publication published since the last update appears in a later extraction. Each publication is stored with its metadata and its original PDF.

## How PSM Publications Work

1. Start a `psm` extraction for the entity.
2. Poll the extraction until it reaches a terminal status.
3. List the entity's PSM publications.
4. Retrieve a publication by ID when you need its details, and download its PDF through the file's download endpoint.

A `psm` extraction is also created when a company entity is created with `psm` among its datasources, or when it is created from SAT credentials and your organization's [first-time scheduler](https://docs.syntage.com/using-syntage/dashboard/extraction-scheduler.md) includes the `psm` extractor. Otherwise, its publications appear once a `psm` extraction runs, whether you start it or a recurring scheduler does.

## Requirements

The entity must be a company (persona moral) with an RFC or a name. PSM publications are filed for companies, so the extraction cannot be created for a person entity. If the entity has neither an RFC nor a name yet, the extraction stays `waiting` until it has one.

The `psm` extractor must be enabled for your organization. If it is not enabled, contact your CSM or [Syntage Support](https://docs.syntage.com/using-syntage/faq/organization-billing-and-support.md#how-do-i-contact-support).

The name is compared without accents, punctuation or the company type, so an entity named `EJEMPLO CAFETERIAS` finds publications for `EJEMPLO CAFETERIAS, S. DE R.L. DE C.V.`. When the entity has an RFC, its name only finds publications that name no company RFC, such as an assembly call a shareholder files in their own name; a publication that names another RFC belongs to another company. When the entity has no RFC, its name finds every publication filed under that name, including one that names a company RFC, which may belong to another company with the same name; these publications have `matchedBy: name`.

When no publication matches the entity, the extraction finishes successfully and finds none. A publication stays with the entity once an extraction finds it, even if a later extraction no longer finds it.

| Field | Description |
| - | - |
| `publicationId` | Publication ID assigned by the PSM portal. |
| `folio` | Folio printed in the publication, `YYYY-NNNNNNNNNN`, sometimes followed by `-001`. `null` when the publication does not print it. |
| `mainFolio` | The folio without its `-001` suffix, which a publication shares with the one it accompanies. `null` when `folio` is `null`. |
| `publishedAt` | When the publication was published, in Mexico City time. `null` when the publication does not print it; such a publication is left out of the `publishedAt` filters. |
| `type` | Official publication type, such as `general_assembly_call` or `capital_increase`. `null` when the publication prints no official type. |
| `title` | The name the filer gave the publication. `null` when the publication does not print it. |
| `company` | RFC and name of the company the publication is for. Either is `null` when the publication does not print it. |
| `filer` | RFC and name of who filed the publication, such as a legal representative, a shareholder or a statutory auditor. Either is `null` when the publication does not print it. |
| `file` | The original publication PDF. |
| `matchedBy` | What the publication shares with the entity: `rfc_and_name` when it names the entity's RFC and a name that compares as the entity's, `rfc` when it names the entity's RFC under another name or there is no name to compare, because the publication names no company name or the entity has no name, and `name` when only the name compares as the entity's. |

Changes to publications are delivered through the `psm_publication.created` and `psm_publication.updated` webhook events.

For the request body, see [Extraction request examples](https://docs.syntage.com/developers/extraction-request-examples.md#psm). For endpoint details, see [List an entity's PSM publications](https://docs.syntage.com/api-reference/ds-mx-psm-publications/list-an-entitys-psm-publications.md) and [Retrieve a PSM publication](https://docs.syntage.com/api-reference/ds-mx-psm-publications/retrieve-a-psm-publication.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.