> ## 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. # List an entity's RUG operations > List RUG operations extracted for an entity. Use this endpoint after a `rug` extraction finishes to review registry acts related to the entity's guarantees. ## OpenAPI ````yaml get /entities/{entityId}/datasources/rug/operaciones openapi: 3.0.2 info: version: '2020-06-28' title: Syntage API contact: name: Email email: support@syntage.com description: > # Introduction The Syntage API is organized around [REST](https://en.wikipedia.org/wiki/Representational_State_Transfer). Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns [JSON-LD](https://json-ld.org) responses, and uses standard HTTP response codes, authentication, and verbs. # Environments | Name | Description | Base URL | |------|-------------|----------| | **Sandbox** | The Sandbox environment is dedicated to development and testing. In this environment, no real taxpayer credentials are required and all interaction with the SAT is simulated generating life-like data, allowing you to pull test data from all endpoints. | https://api.sandbox.syntage.com | | **Production** | The Production environment is dedicated to live applications with real connections to the SAT. In this environment, real taxpayer credentials are required, and you will pull real fiscal data directly from the SAT. | https://api.syntage.com | Each environment has a different API Key for [authentication](#section/Authentication). # Request IDs Each API request has an associated request identifier. You can find this value in the response headers, under `X-Request-ID`: ```curl curl -i https://api.syntage.com HTTP/1.1 200 OK Date: Sun, 29 Nov 2020 19:21:21 GMT X-Request-ID: Root=1-6532dcae-169bf139354cd48959f55c55 ``` If you need to contact us about a specific request, providing the request identifier will ensure the fastest possible resolution. # Rate Limiting Our API employs a number of safeguards against bursts of incoming traffic to help maximize its stability. The returned HTTP headers of any API request show your current rate limit status: ```curl curl -i https://api.syntage.com HTTP/1.1 200 OK Date: Sun, 29 Nov 2020 19:21:21 GMT X-RateLimit-Limit: 60 X-RateLimit-Remaining: 56 X-RateLimit-Reset: 1606678044 ``` | Header Name | Description | |-----------------------|------------------------------------------------------------------------------| | X-RateLimit-Limit | The maximum number of requests you're permitted to make. | | X-RateLimit-Remaining | The number of requests remaining in the current rate limit window. | | X-RateLimit-Reset | The time at which the current rate limit window resets in UTC epoch seconds. | If you exceed the rate limit, a [429 Too Many Requests](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) response is returned: ```http HTTP/1.1 429 Too Many Requests Date: Sun, 29 Nov 2020 19:21:21 GMT X-RateLimit-Limit: 60 X-RateLimit-Remaining: 0 X-RateLimit-Reset: 1606678044 ``` We may reduce limits to prevent abuse, or increase limits to enable high-traffic operations. You can check your current limits in the [dashboard](https://app.syntage.com/settings/usage). To request an increased rate limit, please [contact support](https://support.syntage.com/). # Pagination When issuing a GET request on a collection containing more than 1 page (e.g. [/events](#operation/ListEvent)), a collection is returned. Links to the first, the last, previous and the next page in the collection are displayed as well as the number of total items in the collection. All endpoints that support this operation have a query parameter defined by: - `itemsPerPage` The number of items per page (default: 20, max: 1000) - `page` The collection page number ```bash "hydra:totalItems": 1, "hydra:view": { "@id": "/events?page=1", "@type": "hydra:PartialCollectionView", "hydra:first": "/events?page=1", "hydra:next": "/events?page=2", "hydra:last": "/events?page=3" }, ``` ## Cursor Pagination Cursor pagination is a technique used for navigating through large datasets efficiently. It allows you to retrieve a specific subset of results from a collection by using a cursor value that represents the position within the collection. The cursor serves as a reference point for fetching the next or previous set of results. ### Benefits of Cursor Pagination: 1. **Efficient Navigation:** Cursor pagination eliminates the need to fetch the entire dataset at once, making it more scalable and faster. You can retrieve data in smaller, manageable chunks based on the cursor values. 2. **Consistent Results:** Each page of results in cursor pagination is stable and doesn't change even if new items are added or removed from the collection. This ensures that you get consistent and reliable results. 3. **Flexibility:** Cursors can be used to navigate forwards and backwards in the collection without impacting performance. ### How to Use Cursor Pagination: To use cursor pagination with our API, follow these instructions: 1. Make a request to retrieve the initial page of results. The response will be a JSON-LD document that includes a `hydra:next` attribute with the URI for the next page. The URI already includes the cursor attribute. 2. To retrieve the next page of results, make a GET request to the URI provided in the `hydra:next` attribute. This URI will automatically include the cursor value for the next page. 3. If you want to navigate to the previous page, you can use the `hydra:previous` attribute in the JSON-LD response. It will contain the URI for the previous page, including the cursor value. 4. You can continue making requests to the `hydra:next` and `hydra:previous` URIs to navigate through the paginated results, based on your requirements. Make sure to update your request headers to include the necessary headers for JSON-LD content negotiation, such as `Accept: application/ld+json` or `Content-Type: application/ld+json`. By following these instructions, you can effectively navigate through the paginated results using the cursor values provided in the `hydra:next` and `hydra:previous` attributes, without the need to manually include the cursor in your requests. This simplifies the pagination process and enhances the usability of our API. ### Considerations About Cursor Pagination: - By default, the API uses offset-based pagination (except for a few endpoints that we will list below). If you want to switch to cursor pagination, you need to include an additional header in your request. Set the `X-Pagination-Style` header with the value `"cursor"` to enable cursor pagination. If not specified, the API will assume offset-based pagination. - After enabling cursor pagination, the API response will no longer include the `hydra:totalItems` field by default. Retrieving the total count can be resource intensive and impact response times, especially for large datasets. However, if you need the `hydra:totalItems` information, you can include an additional header in your request. Set the `X-Pagination-Enable-Partial` header with the value `0` to indicate that the response should include extra information, including the `hydra:totalItems` count. Please be aware that enabling this feature may impact API response times, as the backend needs to perform a count operation on the dataset. If you require the `hydra:totalItems` count, please consider the potential impact on API response times. ### Example ```bash curl -i 'https://api.syntage.com/entities/{entityId}/invoices?itemsPerPage=10' \ --header 'Accept: application/ld+json' \ --header 'X-Api-Key: {apiKey}' \ --header 'X-Pagination-Style: cursor' \ --header 'X-Pagination-Enable-Partial: 0' ``` **Note:** We only support cursor pagination for the following endpoints: - `GET /entities/{entityId}/invoices` - `GET /entities/{entityId}/invoices/line-items` - `GET /entities/{entityId}/invoices/{invoiceId}/line-items` - `GET /invoices/{invoiceId}/line-items` - `GET /entities/{entityId}/invoices/payments` Feel free to reach out if you have any further questions or need additional assistance! # Property Filtering The property filter adds the possibility to select the properties for GET operations. Syntax: `?properties[]=&properties[][]=` You can add as many properties as you need. The following example shows how to select `paymentType` and `issuer.rfc` when fetching a list of invoices. ```curl curl -i https://api.syntage.com/entities/{entityId}/invoices?properties[]=paymentType&properties[issuer]=rfc ``` # API Versioning Guide Guidance on changes between versions. ## Version: 2020-01-01 to 2020-06-28 ### **Invoice** _**Affected Endpoints:** `GET /invoices/{id}` and `GET /entities/{entityId}/invoices`_ - The `amount` property has been removed from API responses. Use the `total` property instead. - Retrieval by invoice's `uuid` at `/invoices/{id}` is now removed. To retrieve an invoice, use the invoice's `id` at the specified endpoint. To find an invoice using its `uuid`, filter the invoice collection at `/entities/{entityId}/invoices?uuid[]={uuid}`. - Previously, the `@iri` property for an invoice pointed to the resource using `uuid`, like `/invoices/{uuid}`. Now, it points using its `id`, like `/invoices/{id}`. ### **Entity (Formerly Link)** _**Affected Endpoint:** `GET /entities`_ - Filtering entities by `status` is removed. Use `credential.status` instead. For example, utilize `GET /entities?credential.status[]=active` instead of `GET /entities?status[]=active`. ### **Tax Return** _**Affected Endpoints:** `GET /tax-returns/{id}` and `GET /entities/{entityId}/tax-returns`_ - Retrieval by tax return's `operationNumber` at `/tax-returns/{id}` is removed. To retrieve a tax return, use the tax return's `id` at the mentioned endpoint. To find a tax return using its `operationNumber`, filter the collection at `/entities/{entityId}/tax-returns?operationNumber[]={operationNumber}`. - Previously, the `@iri` property for a tax return pointed to the resource using `operationNumber`, like `/tax-returns/{operationNumber}`. Now, it directs to its `id`, like `/tax-returns/{id}`. ### **Event** _**Affected Endpoints:** `GET /events` and `GET /events/{id}`_ - For events associated to an `tax-return`, the `@iri` property now directs to `/tax-returns/{id}` instead of the previous `/tax-returns/{operationNumber}`. - For events associated to an `invoice`, the `@iri` property now directs to `/invoices/{id}` instead of the previous `/invoices/{uuid}`. ### **Extraction** _**Affected Endpoints:** `GET /extractions` and `GET /extractions/{id}`_ - The `periodFrom` property has been removed. Use `options.period.from` instead. - The `periodTo` property has been removed. Use `options.period.to` instead. ### **File** _**Affected Endpoint:** `GET /file/{id}`_ - For files associated to an `tax-return`, the `@iri` property now directs to `/tax-returns/{id}`, instead of the previous `/tax-returns/{operationNumber}`. - For files associated to an `invoice`, the `@iri` property now directs to `/invoices/{id}`, instead of the previous `/invoices/{uuid}`. ### Trying Out This Version If you want to test this version, you can do so by making any request with the `Accept-Version` header pointing to the latest version: ```curl curl -i 'https://api.syntage.com/entities/{entityId}/invoices' \ --header 'Accept-Version: 2020-06-28' \ --header 'X-Api-Key: {apiKey}' ``` servers: - url: https://api.syntage.com description: Production - url: https://api.sandbox.syntage.com description: Sandbox security: - ApiKey: [] tags: - name: Events description: > Events record meaningful changes to resources in your organization. When something changes, Syntage creates an Event resource. For example, submitting an entity's SAT credential can create credential and entity events, and a completed extraction can create an `extraction.updated` event. Many requests can create more than one event. For example, submitting valid SAT credentials for an entity can create `credential.created`, `credential.updated`, and `link.created` events. Events occur when the state of another resource changes. The state of that resource at the time of the change is embedded in the event's `data` field. For example, a `credential.updated` event contains a Credential, and an `invoice.updated` event contains an Invoice. Use the Events endpoints to retrieve recent events directly. Use [webhooks](/api-reference/webhooks/overview) when you want Syntage to deliver events to your server automatically. Access to events is only guaranteed for 7 days. Entity lifecycle events still use the `link.*` event type names for backwards compatibility. The suffix describes the kind of change: | Suffix | Meaning | | --- | --- | | `.created` | A new resource was created. | | `.updated` | An existing resource changed. | | `.deleted` | A resource was deleted or is no longer available. | | Resource | Event types | | --- | --- | | Credentials | `credential.created`, `credential.updated`, `credential.deleted` | | Entities | `link.created`, `link.updated`, `link.deleted` | | Files | `file.created` | | Extractions | `extraction.created`, `extraction.updated` | | Exports | `export.created`, `export.updated` | | Invoices | `invoice.created`, `invoice.updated`, `invoice.deleted` | | Invoice payments | `invoice_payment.created`, `invoice_payment.updated` | | Invoice line items | `invoice_line_item.created`, `invoice_line_item.updated` | | Tax returns | `tax_return.created`, `tax_return.updated`, `tax_return.deleted` | | Tax status | `tax_status.created`, `tax_status.updated`, `tax_status.deleted` | | Tax compliance checks | `tax_compliance_check.created`, `tax_compliance_check.updated`, `tax_compliance_check.deleted` | | Tax retentions | `tax_retention.created`, `tax_retention.updated`, `tax_retention.deleted` | | Electronic accounting records | `electronic_accounting_record.created`, `electronic_accounting_record.updated` | | RPC entidades | `rpc_entidades.created`, `rpc_entidades.updated` | | RPC socios | `rpc_socios.created`, `rpc_socios.updated` | | RPC actos | `rpc_acto.created`, `rpc_acto.updated` | | Shareholder relations | `shareholder_relation.created`, `shareholder_relation.updated` | | Shareholder relation sources | `shareholder_relation_source.created` | | RUG garantias | `rug_garantia.created`, `rug_garantia.updated` | | Buró de Crédito reports | `buro_de_credito_report.created`, `buro_de_credito_report.updated` | | Background checks | `background_check.created` | | SAT certificates | `sat_certificate.created`, `sat_certificate.updated` | | Company verification reports | `company_verification_report.created`, `company_verification_report.updated` | - name: Exports description: > Export invoices data in csv or xlsx format. Once you requested an export you will receive an email with a link to download the generated file - name: Files description: | Files associated to resources - name: DS MX SAT Credentials - name: DS MX SAT Certificates - name: Entities description: > An Entity is a resource that represents a person or company. Entities can be added via Add Entity, or automatically when a credential is validated (when the status becomes "valid"). This resource controls your access to data and allows you to create new extractions. When an Entity is deleted, all data related to the entity is deleted as well. - name: Extractions description: > Extractions are tasks that retrieve data for an entity from a datasource. They are used to collect invoices, tax returns, tax status, tax compliance checks, RPC records, RUG guarantees, Buró de Crédito reports, BIL reports, and other datasource-backed records. An extraction runs asynchronously. Creating one starts or queues the work, and the returned Extraction resource tracks its status, options, timing, errors, and the number of resources created or updated. ## How Extractions Work 1. Create or retrieve the entity you want to extract data for. 2. Create an extraction with the entity IRI, extractor name, and extractor options. 3. Store the returned extraction ID. 4. Retrieve the extraction until its `status` is `finished` or `failed`. 5. Read the extracted data from the related resource endpoints, such as invoices or tax returns. If the same extraction is already pending or running for the same entity, extractor, and options, Syntage returns a duplicate extraction response instead of starting the same work again. ## Options Options containing a period (`.`) in the name like `period.from` are a way to denote object paths. For example, `period.from` should actually be sent as: ```json { "options": { "period": { "from": "2020-01-01", "to": "2020-12-31" } } } ``` Extractor names and options are specific to the data you are extracting. For extraction-backed resources, use the resource overview page for the extractor name, required credentials, supported options, and the endpoint where the extracted records can be read. # Extraction status | Status | Description | | ------ | ----------- | | pending | The initial extraction status. The extraction is enqueued and waiting to be processed. | | waiting | The extraction does not meet the requirements to begin. | | running | The extraction process started and is currently running. The running time varies depending on the extractor type and the entity's transactional volume. You may find partial data available in our API endpoints during this time. | | finished | The extraction finished successfully. All data is available to be retrieved from our API endpoints. | | failed | The extraction couldn't start or failed during the process. Our internal retry policies weren't able to finish the extraction successfully. We may have partial data available in our API endpoints, but new extractions should be created to ensure all the entity's data is available. You can check the [extraction error code](#section/Extraction-error-codes) to understand why it failed and determine whether it can be retried or not. | | stopping | The extraction was requested to be stopped by the user. It is in the process of being stopped. | | stopped | The extraction was stopped by the user after it started running. This extraction is included in billing. | | cancelled | The extraction was stopped by the user before it started running. This extraction is not included in billing. | # Extraction error codes | Code | Description | Retryable | | ---- | ----------- | --------- | | invalid_credentials | The SAT [Credential](#tag/Credentials) is no longer valid. | No | | login_failed | We couldn't log in with the SAT credential. | Yes | | unrecoverable | The extraction process failed many times, and we reached a maximum number of retries. | Yes | | sat_unavailable | We detected that SAT itself is down or unresponsive. | Yes | | internal_error | We detected an internal error in our own infrastructure. | Yes | | undefined | We couldn't determine the error cause and our internal team will investigate it. | Yes | - name: DS MX SAT Invoices description: > Invoices represent CFDI documents issued or received by an entity. Invoice records include SAT identifiers, issuer and receiver data, monetary totals, payment status, cancellation status, invoice relationships, file availability, and tags. Use the entity invoice list when you need all invoices extracted for one entity. Retrieve an invoice by ID when you need the full invoice resource, including tags and related invoice metadata. Use the CFDI endpoint when you need the XML or PDF content for a specific invoice. ### Blacklist status The field `issuer.blacklistStatus` or `receiver.blacklistStatus` is set when the invoice issuer or receiver RFC is found in the [SAT 69-B list](https://omawww.sat.gob.mx/cifras_sat/Paginas/datos/vinculo.html?page=ListCompleta69B.html): | Status | Description | |-------------|-----------------------------------------------------------------------------------------------------------| | presumed | SAT has identified possible irregularities and started an investigation | | dismissed | SAT dismissed the investigation after reviewing evidence | | definitive | SAT determined that the RFC has confirmed irregularities | | favorable | SAT reversed a definitive status after reviewing additional evidence | - name: DS MX SAT Invoice Line Items - name: DS MX SAT Invoice Relations description: > Invoice relations represent CFDI relationships between invoices, such as substitutions, credit notes, or other SAT-defined relation types. Each relation includes the source invoice, related invoice when Syntage has it, related invoice UUID, and the SAT relation type code. - name: DS MX SAT Tax Retentions - name: DS MX SAT Credit Notes - name: DS MX RPC Entidades description: > RPC entidades are company records extracted from the Registro Publico de Comercio. They group registration profile data, related registry acts, and shareholder records found for an entity. - name: DS MX RPC Actos description: > RPC actos are commercial registry acts associated with an RPC entidade. They can include extracted act data and file references for registry documents. - name: DS MX RPC Socios description: | RPC socios are shareholder or partner records found in RPC filings. - name: Scheduler Rules - name: Schedulers - name: DS MX SAT Invoice Batch Payments description: > Batch payments are derived from payment receipt CFDIs, also known as type `P` invoices. A batch payment groups one or more invoice payments into the payment transaction reported by SAT. Use batch payments when you need payment-method, currency, bank, operation-number, or transaction-level information. Use invoice payments when you need the amount applied to a specific deferred invoice. - name: DS MX SAT Invoice Payments description: > Invoice payments are derived from payment receipt CFDIs, also known as type `P` invoices. A payment receipt records payment activity for a previously issued deferred invoice. Each payment belongs to a batch payment and the invoice it was applied to. Syntage updates the related invoice's `paidAmount`, `dueAmount`, and `fullyPaidAt` fields based on the received payments. - name: DS MX SAT Electronic Accounting - name: DS MX SAT Tax Returns - name: DS MX SAT Tax Compliance Checks description: > A tax compliance check maps the content of Opinion de Cumplimiento de Obligaciones Fiscales, an official SAT document that states whether an RFC is complying with its tax obligations. Each tax compliance check is a snapshot of the compliance result at a specific check date. | Result | Meaning | |---|---| | `positive` | The RFC is complying with its tax obligations | | `negative` | SAT reported one or more compliance issues | | `no_obligations` | SAT reported no active tax obligations | | `activity_suspended` | SAT reported suspended business activity | - name: DS MX SAT Tax Status - name: Cash Flow Insight - name: Balance Sheet Insight - name: Income Statement Insight - name: Invoicing Concentration Insight - name: Customer Concentration Insight - name: Vendor Concentration Insight - name: Employees Insight - name: Expenditures Insight - name: Financial Institutions Insight - name: Financial Ratios Insight - name: Government Customers Insight - name: Invoicing Blacklist Insight - name: Risks Insight - name: Sales Revenue Insight - name: Summary Insight - name: Trial Balance Insight - name: Shareholders Insight - name: RPC Shareholders Insight - name: Customer Network Insight - name: Vendor Network Insight - name: Invoicing Annual Comparison Insight - name: Scores Insight - name: Insight Exports description: | Insight exports return supported entity insights as CSV or XLSX files. - name: Webhook Endpoints description: > Webhook endpoints tell Syntage where to deliver events for your organization. Each endpoint includes the HTTPS delivery URL, subscribed event types, enabled state, payload content type, and signing secret. - name: Webhook Requests description: > Webhook requests are delivery attempts from Syntage to a webhook endpoint. Use them to monitor delivery status, inspect failed deliveries, and connect an event to the endpoint that received it. - name: DS Syntage Score description: > Syntage Score calculates an internal score for a company entity from SAT annual tax return data and tax compliance data. - name: DS MX RUG Operaciones description: > RUG operations are registry acts associated with a movable collateral guarantee. They include operation metadata, guarantee numbers, grantors, parsed boleta data, and file references when available. - name: DS MX RUG Garantias description: > RUG guarantees are movable collateral guarantees registered in Mexico's Registro Unico de Garantias Mobiliarias. - name: DS MX Buró de Crédito Reports description: > Buró de Crédito reports contain credit bureau data generated for an entity by the `buro_de_credito_report` extractor. Reports include the selected product type, provider report ID, parsed provider response, score when available, and generated files such as the report PDF. - name: DS MX Buró de Crédito Authorizations description: > Buró de Crédito authorizations store the consent, RFC, address, and identity data required before Syntage can request Buró de Crédito reports for an entity. - name: Background Checks description: > Background checks provide comprehensive verification and screening data for entities. These checks gather information from various databases and sources to assess risk, verify identity, and provide insights into an entity's background across multiple categories. ### Check Categories Background checks are organized into specific categories: - **personal_identity**: Identity verification and personal information - **criminal_record**: Criminal background and legal history - **legal_background**: Legal proceedings and court records - **business_background**: Business registration and commercial activity - **professional_background**: Professional licenses and certifications - **credit_history**: Credit and financial history - **taxes_and_finances**: Tax compliance and financial records - **affiliations_and_insurances**: Professional affiliations and insurance records - **driving_licenses**: Driving licenses and vehicle permits - **vehicle_information**: Vehicle ownership and registration - **traffic_fines**: Traffic violations and fines - **alert_in_media**: Media mentions and public records - **behavior**: Behavioral patterns and risk indicators - **international_background**: International records and verification - **politically_exposed_person**: PEP (Politically Exposed Person) screening - **document_validation**: Document authenticity verification ### Check Status - **pending**: Background check is being processed - **completed**: Background check has been completed successfully - **error**: Background check encountered an error during processing ### Supported Countries - **MX**: Mexico-specific background checks - **ALL**: International background checks across multiple countries - name: Company Verification Reports description: > Company Verification Reports provide verification of company details and supporting files extracted from trusted sources. Use these endpoints to retrieve reports for a specific entity, list all reports, or download the generated PDF report. - name: Shareholders description: > Shareholders represent individuals or entities that own shares in a company. This resource provides information about shareholders, their relationships with entities, and the sources of shareholder information. ### Shareholder Types - **physical**: Individual person shareholders - **legal**: Corporate entity shareholders - **unknown**: When the shareholder type cannot be determined ### Relation Types - **shareholders**: Indicates the entity's shareholders - **shareholder_of**: Indicates entities that this shareholder owns shares in ### Source Types - **manual**: Manually entered shareholder information - **rpc_socio**: Information sourced from RPC (Registro Público de Comercio) - **company_verification**: Cap-table shareholders synced from a company verification report paths: /entities/{entityId}/datasources/rug/operaciones: get: tags: - DS MX RUG Operaciones summary: List an entity's RUG operations description: >- List RUG operations extracted for an entity. Use this endpoint after a `rug` extraction finishes to review registry acts related to the entity's guarantees. operationId: ListRugOperaciones parameters: - $ref: '#/components/parameters/entityId' - $ref: '#/components/parameters/collectionCursorNextPageParam' - $ref: '#/components/parameters/collectionCursorPreviousPageParam' - $ref: '#/components/parameters/collectionLimit' - name: numeroDeAsiento in: query schema: $ref: '#/components/schemas/RugOperacionNumeroDeAsiento' - name: tipo in: query schema: $ref: '#/components/schemas/RugOperacionTipo' - name: numeroDeGarantia in: query schema: $ref: '#/components/schemas/RugNumeroDeGarantia' - name: fecha[before] in: query schema: $ref: '#/components/schemas/RugOperacionFecha' - name: fecha[strictly_before] in: query schema: $ref: '#/components/schemas/RugOperacionFecha' - name: fecha[after] in: query schema: $ref: '#/components/schemas/RugOperacionFecha' - name: fecha[strictly_after] in: query schema: $ref: '#/components/schemas/RugOperacionFecha' - $ref: '#/components/parameters/createdAtAfter' - $ref: '#/components/parameters/createdAtStrictlyAfter' - $ref: '#/components/parameters/createdAtBefore' - $ref: '#/components/parameters/createdAtStrictlyBefore' - $ref: '#/components/parameters/updatedAtAfter' - $ref: '#/components/parameters/updatedAtStrictlyAfter' - $ref: '#/components/parameters/updatedAtBefore' - $ref: '#/components/parameters/updatedAtStrictlyBefore' - $ref: '#/components/parameters/orderCreatedAt' - $ref: '#/components/parameters/orderUpdatedAt' responses: '200': $ref: '#/components/responses/TaxpayerRugOperacionCollection' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' components: parameters: entityId: name: entityId in: path required: true example: 91106968-1abd-4d64-85c1-4e73d96fb997 schema: type: string format: uuid collectionCursorNextPageParam: name: id[lt] in: query required: false example: 91106968-1abd-4d64-85c1-4e73d96fb997 description: Collection cursor pointer to the next page schema: type: string collectionCursorPreviousPageParam: name: id[gt] in: query required: false example: 91106968-1abd-4d64-85c1-4e73d96fb997 description: Collection cursor pointer to the previous page schema: type: string collectionLimit: name: itemsPerPage in: query required: false description: Number of items per page schema: $ref: '#/components/schemas/CollectionLimit' createdAtAfter: name: createdAt[after] in: query description: Filter by resource creation date (greater than or equal `>=`) example: '2020-01-17 11:47:27' schema: type: string format: date-time createdAtStrictlyAfter: name: createdAt[strictly_after] in: query description: Filter by resource creation date (greater than `>`) example: '2020-01-17 11:47:27' schema: type: string format: date-time createdAtBefore: name: createdAt[before] in: query description: Filter by resource creation date (less than or equal `<=`) example: '2020-01-17 11:47:27' schema: type: string format: date-time createdAtStrictlyBefore: name: createdAt[strictly_before] in: query description: Filter by resource creation date (less than `<`) example: '2020-01-17 11:47:27' schema: type: string format: date-time updatedAtAfter: name: updatedAt[after] in: query description: >- Filter by the date the resource was last updated (greater than or equal `>=`) example: '2020-01-17 11:47:27' schema: type: string format: date-time updatedAtStrictlyAfter: name: updatedAt[strictly_after] in: query description: Filter by the date the resource was last updated (greater than `>`) example: '2020-01-17 11:47:27' schema: type: string format: date-time updatedAtBefore: name: updatedAt[before] in: query description: >- Filter by the date the resource was last updated (less than or equal `<=`) example: '2020-01-17 11:47:27' schema: type: string format: date-time updatedAtStrictlyBefore: name: updatedAt[strictly_before] in: query description: Filter by the date the resource was last updated (less than `<`) example: '2020-01-17 11:47:27' schema: type: string format: date-time orderCreatedAt: name: order[createdAt] in: query description: Order by resource creation date schema: $ref: '#/components/schemas/CollectionOrder' orderUpdatedAt: name: order[updatedAt] in: query description: Order by resource update date schema: $ref: '#/components/schemas/CollectionOrder' schemas: RugOperacionNumeroDeAsiento: type: number description: RUG seat number for the operation example: 12345678 RugOperacionTipo: type: string description: Type of RUG operation enum: - anotacion - aviso_preventivo - cancelacion - cancelacion_de_anotacion - certificacion - inscripcion - modificacion - modificacion_de_anotacion - rectificacion_de_anotacion - rectificacion_por_error - renovacion_o_reduccion_de_vigencia - renovacion_vigencia_de_anotacion - transmision example: inscripcion RugNumeroDeGarantia: type: number description: RUG guarantee number example: 123456 RugOperacionFecha: type: string format: date-time description: Date and time of the RUG operation example: '2021-10-12T00:00:00.000Z' CollectionLimit: type: integer default: 20 minimum: 1 maximum: 1000 CollectionOrder: type: string enum: - asc - desc example: asc TaxpayerRugOperacionCollection: allOf: - $ref: '#/components/schemas/CursorCollection' - type: object properties: '@context': default: /contexts/RugOperacion '@id': default: /entities/{entityId}/datasources/rug/operaciones example: >- /entities/91106968-1abd-4d64-85c1-4e73d96fb997/datasources/rug/operaciones hydra:member: items: $ref: '#/components/schemas/RugOperacionFull' CursorCollection: type: object properties: '@context': type: string '@id': type: string '@type': type: string default: hydra:Collection hydra:member: type: array items: type: object hydra:view: type: object description: Pagination information properties: '@id': type: string format: iri-reference description: Current page IRI reference '@type': type: string default: hydra:PartialCollectionView hydra:next: type: string example: >- /entity/2a15f539-3251-48e1-aaeb-a154dc9c6edb/resource?id[lt]=9b8e5365-0b36-45f5-9c76-fbe439632367 description: Next page IRI reference; omitted when there is no pagination hydra:last: type: string example: >- /entity/2a15f539-3251-48e1-aaeb-a154dc9c6edb/resource?id[gt]=9b8e5365-0b36-45f5-9c76-fbe439632367 description: Last page IRI reference; omitted when there is no pagination hydra:search: type: object properties: '@type': type: string hydra:template: type: string hydra:variableRepresentation: type: string hydra:mapping: type: array items: type: object properties: '@type': type: string variable: type: string property: type: string required: type: boolean RugOperacionFull: allOf: - $ref: '#/components/schemas/RugOperacionPartial' - type: object description: Full RUG operation details properties: numeroDeGarantia: $ref: '#/components/schemas/RugNumeroDeGarantia' otorgantes: type: array items: $ref: '#/components/schemas/RugOperacionOtorgante' boleta: $ref: '#/components/schemas/RugOperacionBoleta' RugOperacionPartial: type: object description: RUG operation summary properties: '@id': type: string format: iri-reference description: RUG operation IRI reference example: /datasources/rug/operaciones/99c13810-868f-482e-a6f1-878254248d27 '@type': type: string default: RugOperacion id: $ref: '#/components/schemas/RugOperacionID' numeroDeAsiento: $ref: '#/components/schemas/RugOperacionNumeroDeAsiento' tipo: $ref: '#/components/schemas/RugOperacionTipo' fecha: $ref: '#/components/schemas/RugOperacionFecha' file: $ref: '#/components/schemas/RugOperacionFile' createdAt: $ref: '#/components/schemas/createdAt' updatedAt: $ref: '#/components/schemas/updatedAt' RugOperacionOtorgante: type: object description: Grantor associated with a RUG operation properties: nombre: type: string description: Grantor name example: El Otorgante de Garantías Mobiliarias, S.A. de C.V. folio_electronico: type: string description: Grantor electronic folio example: 34011*7 RugOperacionBoleta: type: object description: Parsed RUG boleta data for the operation properties: datos_del_asiento: type: object properties: numero_de_asiento_cadena_unica_de_datos: type: string example: 12345678 numero_de_garantia_mobiliaria: type: string example: 123456 fecha_y_hora: type: string example: 11/03/2022 - 00:18:32 * ZULU GMT / UTC vigencia: type: string example: 12 meses inscrito_en_el_folio_mercantil_no: type: string example: 34011*7 datos_del_otorgante: type: array items: type: object properties: nombre_denominacion_o_razon_social: type: string example: El Otorgante de Garantías Mobiliarias, S.A. de C.V. folio_electronico: type: string example: 34011*7 el_otorgante_de_la_garantia_mobiliaria_es_deudor: type: string example: Si datos_del_acreedor: type: object properties: nombre_denominacion_o_razon_social: type: string example: Grupo Financiero Acreedor, S.A.P.I. de C.V., SOFOM E.N.R. telefono: type: string example: 12345678 extension: type: string example: N/A correo_electronico: type: string example: persona.a@acreedor.com.mx,persona.b@acreedor.com.mx domicilio_para_efectos_del_rug: type: string example: >- Av. Paseo de la Reforma 296, Juárez, Cuauhtémoc, 06600 Ciudad de México, CDMX datos_de_los_acreedores_adicionales: type: array items: type: object properties: nombre_denominacion_o_razon_social: type: string example: >- Grupo Financiero Acreedor Adicional, S.A.P.I. de C.V., SOFOM E.N.R. telefono: type: string example: 12345678 extension: type: string example: 543 correo_electronico: type: string example: persona@acredoor2.com.mx domicilio_para_efectos_del_rug: type: string example: >- Av. Luis Barragan 505, Santa Fe, Contadero, Cuajimalpa de Morelos, 05348 Ciudad de México, CDMX folio_electronico: type: string example: 12345*6 datos_de_los_deudores: type: array items: type: object properties: nombre_denominacion_o_razon_social: type: string example: El Otorgante de Garantías Mobiliarias, S.A. de C.V. datos_de_la_garantia_mobiliaria: type: object properties: tipo_de_garantia_mobiliaria: type: string example: Factoraje Financiero fecha_de_celebracion_del_acto_o_contrato_o_del_surgimiento_de_los_derechos_de_retencion_o_privilegios_especiales: type: string example: 08/03/2021 monto_maximo_garantizado_y_moneda: type: string example: $ 12345.67 Peso Mexicano tipo_de_bienes_muebles_objeto_de_la_garantia_mobiliaria: type: string example: Derechos, incluyendo derechos de cobro. descripcion_de_los_bienes_muebles_objeto_de_la_garantia_mobiliaria: type: string example: Factura con el folio fiscal 99c13810-868f-482e-a6f1-878254248d27 el_acto_o_contrato_preve_incrementos_reducciones_o_sustituciones_de_los_bienes_muebles_o_del_monto_garantizado: type: string example: >- Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quisque vehicula blandit feugiat. Nullam ligula nunc, vehicula non porta quis, eleifend id leo. Nulla et nisl vulputate, commodo urna sit amet, pharetra leo. Aliquam erat volutpat. datos_del_instrumento_publico_mediante_el_cual_se_formalizo_el_acto_o_contrato: type: string example: >- Proin laoreet posuere velit eget interdum. Donec interdum risus quam, porta laoreet dui consectetur nec. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. terminos_y_condiciones_del_acto_o_contrato_de_la_garantia_mobiliaria: type: string example: >- Integer molestie urna vitae dolor consectetur, ut molestie libero pulvinar. datos_del_acto_o_contrato_que_creo_la_obligacion_garantizada: type: object properties: declaro_bajo_protesta_de_decir_verdad_que_se_solicito_al_otorgante_de_la_garantia_manifestacion_respecto_de_la_no_existencia_de_garantias_otorgadas_previamente_referente_a_los_bienes_objeto_de_esta_garantia: type: string example: Si acto_o_contrato_que_creo_la_obligacion_garantizada: type: string example: >- Vivamus nisi leo, dapibus a tellus eu, dictum convallis neque. Suspendisse ut diam sollicitudin, congue tortor in, mollis felis. Vestibulum id ornare lacus. fecha_de_celebracion_del_acto_o_contrato: type: string example: 08/03/2021 fecha_de_terminacion_del_acto_o_contrato: type: string example: 08/03/2022 terminos_y_condiciones_del_acto_o_contrato_que_creo_la_obligacion_garantizada: type: string example: >- Donec euismod bibendum porttitor. Suspendisse cursus venenatis fringilla. Nulla ornare elementum gravida. Nam lectus mi, tincidunt sed vehicula nec, interdum ut lacus. Vestibulum nec nibh elit. persona_que_firmo_el_asiento: type: object properties: nombre: type: string example: Juan Robles Hernández en_su_caracter_de: type: string example: ACREEDOR persona_que_solicita_o_autoridad_que_instruye_el_asiento: type: object properties: nombre_y_cargo: type: string example: N/A firma_electronica: type: object properties: cadena_original_solicitante: type: string example: MkdQYUeOZGNIU3AXa080V05jQkNGMzNDSitZPXwzMzczLzA5NA== sello_solicitante: type: string example: >- pBFfNh/Ox2+GiivFcx8xjMamo+njQpo/AtJlMCA/3TYByMnhPBP0kJjYhmAu7YhmCGg6K2AKrPIpVlOgS53nZH/kRBp0a0WdDCuhL7sZYdTuuGYa7IqvdkuGqCxppF6/JphYto7pgsKpozW5WleP+wE6Y37ZWSD9SvgfDIliL3faL3EBOQhNb3R3t+GcpzIyvhAtlONfsp0aHPo+1Ngr/7jwwXPaFQuKtVonWB7e0R4E4QmaEPAdkmFg0wfCCOuYufRCtqqgAVVHvV5DpBabp83w470qDVrmDyYTnbpFeg5pdN0k4vtESaSkVwGaxNnnVKNQ4j9sVG+KO0a2aej8xw== certificado_solicitante: type: string example: >- SERIALNUMBER=ROSR561225HDFJNC00, OID.2.5.4.45=ROSR561225HD0, EMAILADDRESS=juan.roblesh@gmail.com, C=MX, O=JUAN ROBLES HERNÁNDEZ, OID.2.5.4.41=JUAN ROBLES HERNÁNDEZ, CN=JUAN ROBLES HERNÁNDEZ sello_de_tiempo: type: string example: >- Certificado AC:O=Secretaria de Economia, OU=nCipher DSE ESN:48D7-2DFC-BF7B, CN=TS A1.economia.gob.mx, C=MX, ST=Ciudad de Mexico, L=Alvaro Obregon|Fecha: 202203110 01832.21Z|Numero de secuencia:107221737826163|Digestion: PUS8fSphg13dOKjPYoMVN82 DCLg= cadena_original_rug: type: string example: MkdQYUdOZGNIx3RXa080V05jQkNGMzNDSitZPXrzMzczNzA2NA==|k|d sello_rug: type: string example: >- B7auogaFXWzNO7EBganQX6Bm/XmU12bYsP8ahtNagGNEuLJ0EekYmjdNvBvzd5/x9Mr6ypXCcLue+2ZNEjf4BWzElZdmsI69/GWTOp6ULozM2eFZMzLSL/He6WGtkoceWulElNDApb0PUkfaDOovlkVSZYkG0HTmZ/C9fJLYMvzA2LrazeEDibqp/M9l9HTgwCa+7NcLi+eAKYDGXCfbhnfsdFpkk338hQoc4TPyoB0sy5bUFCwwM7kCD/6ZSTy8QAXm9nvdt8vX/UktryZwUB72shedXWqQx3QtWJWpWHgi1cl0gQSial00a1pQspFVXvcX5rC5mEdzeezhsECVfg== numero_serie_rug: type: string example: 123 certificado_rug: type: string example: >- EMAILADDRESS=contacto_rug@economia.gob.mx, O=Secretaria de Economia, OU=Direccion General de Normatividad Mercantil, CN=RUG. Ernesto del Castillo Hernandez, T=Di rector de Coordinacion del Registro Publico de Comercio, STREET="Insurgentes Sur 1940, Piso 1", OID.2.5.4.17=01030, C=MX, ST=Ciudad de Mexico, L=Alvaro Obregon, OID.2.5.4.45=#030E0043414845363731313037535638, SERIALNUMBER=CAHE671107HDFSRR03 , OID.2.5.4.20=(55)5229 6100 Ext. 33529 RugOperacionID: type: string format: uuid description: RUG operación identifier example: 99c13810-868f-482e-a6f1-878254248d27 RugOperacionFile: type: string format: iri-reference description: File resource for the RUG operation document example: /files/99c13810-868f-482e-a6f1-878254248d27 createdAt: type: string description: Date and time the resource was created example: '2020-01-01T12:15:00.000Z' updatedAt: type: string description: Date and time the resource was last updated example: '2020-01-01T12:15:00.000Z' responses: TaxpayerRugOperacionCollection: description: RUG operación collection response content: application/ld+json: schema: $ref: '#/components/schemas/TaxpayerRugOperacionCollection' Unauthorized: description: Unauthorized content: application/json: schema: type: object properties: message: type: string NotFound: description: Not found content: application/json: schema: type: object properties: message: type: string securitySchemes: ApiKey: type: apiKey in: header name: X-API-Key description: > Your API key is available in the [Production](https://app.syntage.com/settings/api-keys) and [Sandbox](https://app.sandbox.syntage.com/settings/api-keys) dashboards. ````