{ "servers": [ { "url": "https://public-api.mx.clara.com" }, { "url": "https://public-api.br.clara.com" }, { "url": "https://public-api.co.clara.com" }, { "url": "https://public-beta-api.mx.clara.com" }, { "url": "https://public-beta-api.br.clara.com" }, { "url": "https://public-beta-api.co.clara.com" } ], "paths": { "/api/v2/billing-statements/{yyyy:\\d{4}}/{MM:\\d{2}}": { "get": { "tags": [ "Billing-Statements" ], "description": "Find all transactions in a billing statement given the year and month of it's due date.", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Year of the billing statement (always 4 digits)", "example": 2024, "in": "path", "name": "yyyy:\\d{4", "required": true, "schema": { "type": "string" } }, { "description": "Month of the billing statement (always 2 digits)", "example": "01", "in": "path", "name": "MM:\\d{2", "required": true, "schema": { "type": "string" } }, { "description": "UUID of the user associated with the transactions", "name": "userUuid", "in": "query", "schema": { "type": "string" } }, { "description": "UUID of the card associated with the transactions", "name": "cardUuid", "in": "query", "schema": { "type": "string" } } ], "operationId": "findByMonthAndYear", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation ()", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillingStatementDetailsV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all transactions in a billing statement given the year and month of it's due date." } }, "/v1/api-docs": { "servers": [ { "url": "https://public-api.mx.clara.com" }, { "url": "https://public-api.br.clara.com" }, { "url": "https://public-api.co.clara.com" }, { "url": "https://public-beta-api.mx.clara.com" }, { "url": "https://public-beta-api.br.clara.com" }, { "url": "https://public-beta-api.co.clara.com" } ] }, "/api/v2/cards/{uuid}/lock": { "patch": { "tags": [ "Cards" ], "description": "Toggle Card Lock", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/ToggleCardLockRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Card's UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "updateCard_1", "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": { "schema": {} } } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "summary": "Toggle Card Lock" } }, "/api/v2/attachments/{uuid}": { "get": { "tags": [ "Attachments" ], "description": "Get a single attachment information with the pre signed URL", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "UUID of the attachment", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "get-single-attachment", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation ()", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttachmentDTO" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Get a single attachment information with the pre signed URL" } }, "/api/v2/groups/{uuid}": { "delete": { "tags": [ "Groups" ], "description": "Delete a single group by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "UUID of the group to delete", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "deleteGroup", "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "summary": "Delete a single group by UUID" }, "get": { "tags": [ "Groups" ], "description": "Find group by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Group UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findGroup", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find group by UUID" } }, "/api/v2/labels/bulk-delete": { "post": { "tags": [ "Labels" ], "description": "Bulk delete labels", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/LabelsRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "deleteLabels", "summary": "Bulk delete labels" } }, "/api/v2/cards": { "get": { "tags": [ "Cards" ], "description": "Find all cards", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "UUID of the user for which to retrieve cards", "name": "userUuid", "in": "query", "schema": { "type": "string" } }, { "description": "Username of the user", "name": "username", "in": "query", "schema": { "type": "string" } }, { "description": "Status of the cards", "name": "status", "in": "query", "schema": { "enum": [ "NONE", "SELECTED_FOR_STAMPING", "PENDING_ACK", "SELECTED_FOR_PRINTING_DUE_TO_RENEWAL", "PENDING_ACK_OF_RECEIPT_FOR_RENEWAL", "ACTIVE_HELD_BY_CARDHOLDER", "PENDING_PIN_CHANGE_BY_REGISTRATION", "PENDING_THE_FIRST_OPERATION_WITH_A_CORRECT_PIN_BY_REGISTRATION", "COLLECTED_DUE_TO_SERVICE_CANCELLATION", "PENDING_TO_COLLECT_DUE_TO_SERVICE_CANCELLATION", "NOT_ISSUED", "PENDING_PICKING_UP_ANOTHER", "SELECTED_FOR_STAMPING_BY_MASS_REGISTRATION", "PENDING_ACK_OF_RECEIPT_FOR_MASSIVE_REGISTRATION", "INACTIVE_CARD_REISSUED_DUE_TO_PAN_CHANGE", "ERROR_IN_STAMPING", "PENDING_PIN_CHANGE_DUE_TO_RENEWAL", "PENDING_THE_FIRST_OPERATION_WITH_THE_CORRECT_PIN_DUE_TO_RENEWAL", "ACTIVE_IN_THE_RENEWAL_PERIOD", "SELECTED_FOR_STAMPING_AFTER_REISSUING", "PENDING_ACK_AFTER_REISSUING", "PENDING_PIN_CHANGE_DUE_TO_REISSUE", "PENDING_THE_FIRST_OPERATION_WITH_THE_CORRECT_PIN_DUE_TO_REISSUE", "SELECTED_FOR_STAMPING_BY_CONTRACT_UPGRADE", "PENDING_ACK_OF_RECEIPT_FOR_A_CONTRACT_UPGRADE", "INACTIVE_DUE_TO_CONTRACT_UPGRADE", "ACTIVE_IN_THE_REISSUE_PERIOD" ] } }, { "description": "Periodicity of the cards.", "name": "periodicity", "in": "query", "schema": { "enum": [ "DAILY", "MONTHLY", "NONE" ] } }, { "description": "Brand of the cards", "name": "brand", "in": "query", "schema": { "enum": [ "NONE", "VISA", "MASTER" ] } }, { "description": "Type of the cards", "name": "type", "in": "query", "schema": { "enum": [ "MASTER_WORLD_ELITE", "MASTER_CORPORATE", "MASTER_VIRTUAL", "VISA_PHYSICAL", "VISA_VIRTUAL" ] } }, { "description": "User ERP ID", "name": "userErpId", "in": "query", "schema": { "type": "string" } } ], "operationId": "findAllCards", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CardPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all cards" }, "post": { "tags": [ "Cards" ], "description": "Create Card", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CreationCardRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": { "schema": {} } } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "createCard", "summary": "Create Card" } }, "/api/v2/locations/{uuid}": { "get": { "tags": [ "Locations" ], "description": "Find location by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Location UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findLocation", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find location by UUID" } }, "/api/v2/users/{uuid}": { "get": { "tags": [ "Users" ], "description": "Find user by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "User UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findUser", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find user by UUID" } }, "/api/v2/cards/{uuid}": { "patch": { "tags": [ "Cards" ], "description": "Update Card Threshold", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UpdateCardThresholdRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Card's UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "updateCard", "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": { "schema": {} } } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "summary": "Update Card Threshold" }, "get": { "tags": [ "Cards" ], "description": "Find cards by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Card UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findCards", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CardV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find cards by UUID" } }, "/api/v2/payments": { "get": { "tags": [ "Payments" ], "description": "Find payments by parameters", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "Id of the payment", "name": "id", "in": "query", "schema": { "type": "string" } }, { "description": "BatchId of the payments", "name": "batchId", "in": "query", "schema": { "type": "string" } }, { "description": "External Id of the optional boleto", "name": "externalId", "in": "query", "schema": { "type": "string" } }, { "description": "Bar code number that describes the payment", "name": "barcode", "in": "query", "schema": { "type": "string" } }, { "description": "Number sequence that describes the payment", "name": "digitableLine", "in": "query", "schema": { "type": "string" } }, { "description": "Creation start date of the payment", "name": "creationStartDate", "in": "query", "schema": { "type": "string" } }, { "description": "Creation end date of the payment", "name": "creationEndDate", "in": "query", "schema": { "type": "string" } }, { "description": "The transaction ID related to the receipt", "name": "transactionId", "in": "query", "schema": { "type": "string" } }, { "description": "Document number of the beneficiary", "name": "beneficiaryDocumentNumber", "in": "query", "schema": { "type": "string" } }, { "description": "Name of the beneficiary", "name": "beneficiaryName", "in": "query", "schema": { "type": "string" } }, { "description": "Start date of the payment", "name": "paymentDateStart", "in": "query", "schema": { "type": "string" } }, { "description": "End date of the payment", "name": "paymentDateEnd", "in": "query", "schema": { "type": "string" } } ], "operationId": "findBatchOfPayments", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find payments by parameters" }, "post": { "tags": [ "Payments" ], "description": "Create Payment", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/PaymentRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "401": { "description": "Unauthorized" }, "204": { "description": "No content" }, "201": { "description": "Payments created successfully", "content": { "*/*": { "schema": { "items": { "$ref": "#/components/schemas/PaymentResponse" } } } } }, "default": { "description": "default response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaymentResponseList" } } } }, "403": { "description": "Forbidden" } }, "operationId": "createPayment", "summary": "Create Payment" } }, "/api/v2/labels": { "get": { "tags": [ "Labels" ], "description": "Find all labels", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "Name of the label", "name": "name", "in": "query", "schema": { "type": "string" } }, { "description": "Active status of the label", "name": "active", "in": "query", "schema": {} } ], "operationId": "findAllLabels", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation (Detailed information about the label)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all labels" }, "post": { "tags": [ "Labels" ], "description": "Create multiple labels", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/LabelsRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "createLabels", "summary": "Create multiple labels" } }, "/api/v2/transactions": { "get": { "tags": [ "Transactions" ], "description": "Find all transactions", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "Sort the results by specific fields and directions. (accountingDate | operationDate),(ASC | DESC)", "name": "sort", "in": "query", "schema": { "type": "string" }, "example": "accountingDate,ASC" }, { "description": "Operation start date", "name": "operationDateRangeStart", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" }, { "description": "Operation max date", "name": "operationDateRangeEnd", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" }, { "description": "Accounting start date", "name": "accountingDateRangeStart", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" }, { "description": "Accounting max date", "name": "accountingDateRangeEnd", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" }, { "description": "UUID of the user associated with the transactions", "name": "userUuid", "in": "query", "schema": { "type": "string" } }, { "description": "UUID of the card associated with the transactions", "name": "cardUuid", "in": "query", "schema": { "type": "string" } }, { "description": "Masked Pan Last Digits of the card associated with the transactions", "name": "cardLastDigits", "in": "query", "schema": { "type": "string" } }, { "description": "Merchant category of the transactions", "name": "merchantCategoryDescription", "in": "query", "schema": { "type": "string" } }, { "description": "ERP id of the transaction user", "name": "userErpId", "in": "query", "schema": { "type": "string" } }, { "description": "Username of the transaction user", "name": "username", "in": "query", "schema": { "type": "string" } }, { "description": "Operation status", "name": "operationTypeCode", "in": "query", "schema": { "enum": [ "ECONOMIC_CONCEPT", "NOTIFICATION", "PENDING", "PAYMENT", "PAYMENT_LITE", "PAYMENT_SERVICE", "AUTHORIZED" ] } } ], "operationId": "findAllTransactions", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation (Invoice info of the transaction is available only for transactions in Mexico.)", "content": { "application/json": { "schema": { "example": { "content": [ { "merchant": { "description": "Bridge and Road Fees, Tolls", "category": { "description": "Transportation", "code": "14" }, "code": "4784", "commerceName": "TELEVIA RECARGAS APPV3" }, "lastUpdate": "2024-09-29", "operationDate": "2024-09-28", "invoices": null, "originalAmount": { "currency": { "name": "Mexican Peso", "code": "MXN", "number": "484", "monetaryUnits": "2" }, "value": 20.0 }, "hasReceipt": null, "card": { "claraStatus": "ACTIVE", "lockCode": "UNLOCKED", "threshold": 1500.0, "alias": "Tarjeta Demo Some User", "periodicity": "MONTHLY", "maskedPan": "123456******9876", "type": "MASTER_VIRTUAL", "user": { "username": "some.username@clara.team", "location": null, "taxIdentifier": "SOMEUSERNAMEHERE", "userFullName": "Some Username Here", "uuid": "d253a344-13d5-4c5d-b397-f6973611082d", "role": "COMPANY_OWNER", "status": "ACTIVE", "erpId": null }, "brand": "MASTER", "status": "ACTIVE_HELD_BY_CARDHOLDER", "uuid": "ca6f5ce4-ff2d-4391-82c1-d713d672b3ae" }, "bankConcept": { "description": "CONSUMO NACIONAL", "number": "0005" }, "accountingDate": null, "status": "PENDING", "amount": { "currency": { "name": "Mexican Peso", "code": "MXN", "number": "484", "monetaryUnits": "2" }, "value": 20.0 }, "type": "PURCHASE", "uuid": "3904575a-f237-45b2-b1d6-88a4ee3a6231", "authorizationNumber": "662508", "attachments": null, "label": "TELEVIA RECARGAS APPV3", "hasInvoice": null, "comment": null, "labels": null, "billingStatement": null } ], "numberOfElements": 100, "last": false, "pageable": { "pageSize": 100, "paged": true, "unpaged": false, "pageNumber": 0, "offset": 0, "sort": { "sorted": true, "unsorted": false, "empty": false } }, "size": 100, "totalElements": 1, "sort": { "sorted": true, "unsorted": false, "empty": false }, "first": true, "totalPages": 1, "empty": false, "number": 0 }, "$ref": "#/components/schemas/TransactionPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all transactions" } }, "/api/v2/transactions/{uuid}": { "get": { "tags": [ "Transactions" ], "description": "Find transaction by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Transaction UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findTransaction", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation (Invoice info of the transaction is available only for transactions in Mexico.)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransactionV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find transaction by UUID" } }, "/api/v2/billing-statements/current": { "get": { "tags": [ "Billing-Statements" ], "description": "Find all transactions in the open billing statement.", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "UUID of the user associated with the transactions", "name": "userUuid", "in": "query", "schema": { "type": "string" } }, { "description": "UUID of the card associated with the transactions", "name": "cardUuid", "in": "query", "schema": { "type": "string" } } ], "operationId": "findCurrent", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation ()", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BillingStatementDetailsV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all transactions in the open billing statement." } }, "/v2/api-docs": { "servers": [ { "url": "https://public-api.mx.clara.com" }, { "url": "https://public-api.br.clara.com" }, { "url": "https://public-api.co.clara.com" }, { "url": "https://public-beta-api.mx.clara.com" }, { "url": "https://public-beta-api.br.clara.com" }, { "url": "https://public-beta-api.co.clara.com" } ] }, "/api/v2/invoices": { "get": { "tags": [ "Invoices" ], "description": "Find all Invoices with optional filters", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "Invoice number to filter invoices", "name": "invoiceNumber", "in": "query", "schema": { "type": "string" } }, { "description": "Transaction UUID to filter invoices", "name": "transactionUuid", "in": "query", "schema": { "type": "string" } }, { "description": "Invoice ID to filter invoices", "name": "invoiceId", "in": "query", "schema": { "type": "string" } }, { "description": "Start date for invoice date range filter", "name": "startDocumentDate", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" }, { "description": "End date for invoice date range filter", "name": "endDocumentDate", "in": "query", "schema": { "type": "string" }, "example": "YYYY-MM-DD" } ], "operationId": "findAllInvoices", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InvoicePage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all Invoices with optional filters" } }, "/api/v2/locations": { "get": { "tags": [ "Locations" ], "description": "Find all locations", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } } ], "operationId": "findAllLocations", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LocationPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all locations" } }, "/api/v2/attachments/{uuid}/base64": { "get": { "tags": [ "Attachments" ], "description": "Get a single attachment in base 64", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "UUID of the attachment", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "get-single-attachment-base64", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation (Output example: A plain text containing only the word Clara \"data:@file/plain;base64,Q2xhcmE=\")", "content": { "application/json": { "example": "data:@file/plain;base64,Q2xhcmE=", "schema": { "type": "string" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Get a single attachment in base 64" } }, "/api/v2/groups": { "put": { "tags": [ "Groups" ], "description": "Update group details", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UpdateGroupRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "updateGroup", "summary": "Update group details" }, "get": { "tags": [ "Groups" ], "description": "Find all groups", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } } ], "operationId": "findAllGroups", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GroupPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all groups" }, "post": { "tags": [ "Groups" ], "description": "Create Group", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/CreationGroupRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreationGroupResponse" } } } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "createGroup", "summary": "Create Group" } }, "/api/v2/users": { "get": { "tags": [ "Users" ], "description": "Find all users", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Zero-based page index (0..N)", "name": "page", "in": "query", "schema": { "default": 0 } }, { "description": "The size of the page to be returned", "name": "size", "in": "query", "schema": { "default": 100 } }, { "description": "Status of the user", "name": "statusName", "in": "query", "allowEmptyValue": true, "schema": { "enum": [ "ONBOARDING_CANDIDATE", "WAITING", "DELETED", "ACTIVE", "LOCKED", "INACTIVE", "PENDING", "MASTER_LOCKED", "CLARA_BLOCKED" ] } }, { "description": "Role of the user.", "name": "role", "in": "query", "allowEmptyValue": true, "schema": { "enum": [ "EMPLOYEE", "MANAGER", "COMPANY_OWNER", "BOOKKEEPER" ] } } ], "operationId": "findAllUsers", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation", "content": { "application/json": { "schema": { "example": { "pageable": { "pageSize": 100, "paged": true, "unpaged": false, "pageNumber": 0, "offset": 0, "sort": { "sorted": true, "unsorted": false, "empty": false } }, "numberOfElements": 100, "last": false, "totalPages": 1, "content": [ { "cards": null, "location": { "name": "CDMX", "uuid": "976e2c62-ad15-448a-834d-941595e415ff" }, "status": "ACTIVE", "groups": null, "manager": null, "userFullName": "Some Username Here", "uuid": "d253a344-13d5-4c5d-b397-f6973611082d", "username": "some.username@clara.team", "erpId": null, "taxIdentifier": "SOMEUSERNAMEHERE", "role": "COMPANY_OWNER" } ], "size": 100, "totalElements": 1, "number": 0, "first": true, "empty": false, "sort": { "sorted": true, "unsorted": false, "empty": false } }, "$ref": "#/components/schemas/UserPage" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find all users" }, "post": { "tags": [ "Users" ], "description": "Create an User", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UserResponse" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": { "schema": {} } } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "operationId": "createUser", "summary": "Create an User" } }, "/api/v2/attachments": { "get": { "tags": [ "Attachments" ], "description": "Get a list of attachments and it's respective transactions", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation ()", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListTransactionAttachmentsDTO" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "operationId": "get-all-attachments", "summary": "Get a list of attachments and it's respective transactions" } }, "/api/v2/labels/{uuid}": { "delete": { "tags": [ "Labels" ], "description": "Delete a single label by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Label's UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "deleteLabel", "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "summary": "Delete a single label by UUID" }, "patch": { "tags": [ "Labels" ], "description": "Update label details", "requestBody": { "content": { "*/*": { "schema": { "$ref": "#/components/schemas/UpdateLabelRequest" } } } }, "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Label's UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "updateLabel", "responses": { "400": { "description": "Bad Request" }, "default": { "description": "default response", "content": { "application/json": {} } }, "403": { "description": "Forbidden" }, "204": { "description": "No content" }, "401": { "description": "Unauthorized" } }, "summary": "Update label details" }, "get": { "tags": [ "Labels" ], "description": "Find label by UUID", "security": [ { "oauth2": [] }, { "mutualTLS": [] } ], "parameters": [ { "description": "Label UUID", "name": "uuid", "in": "path", "required": true, "schema": { "type": "string" } } ], "operationId": "findLabel", "responses": { "400": { "description": "Bad Request" }, "200": { "description": "Successful operation (Detailed information about the label)", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelV2" } } } }, "401": { "description": "Unauthorized" }, "403": { "description": "Forbidden" }, "204": { "description": "No content" } }, "summary": "Find label by UUID" } } }, "info": { "description": "Clara API use MTLS authentication require two-way TLS certificate exchange between the API Client and Clara Server.\n\nGetting Client Credentials and Certificates:\n\n- Log in to the Clara platform using your credentials.\n- Create a new project within the platform, specifying the project name, validity period and necessary permissions.\n- Download the Client Certificate and Credentials necessary once the project has been setup.\n\nAuthentication and Access to the Clara API:\n\n- To gain access to the API send a request to /oauth/token\n- Include the necessary parameters in your request, such as the client_id and client_secret, along with the certificates.\n- On successful request you will receive an access_token, scopes, and the number of expiration days for the token.\n- Refer to the documentation to see the appropriate requirements.\n\nUsing the Access Token:\n\n- Refer to the API documentation provided by Clara to check the available endpoints and their functionalities.\n- Include the access token in the request headers 'bearer token' of your API requests, along with the certificates.\n- Ensure that the access token is valid and has the necessary scopes to perform the action.\n", "title": "Clara API", "version": "1.0", "contact": { "email": "contacto@clara.com" } }, "openapi": "3.1.0", "externalDocs": { "url": "https://ayuda.clara.com.mx/hc/es-mx/articles/17827687040787-Clara-API" }, "components": { "securitySchemes": { "mutualTLS": { "type": "mutualTLS" }, "oauth2": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://public-api..clara.com/oauth/token", "scopes": {} } } } }, "schemas": { "Category": { "properties": { "description": { "type": "string" }, "code": { "type": "string" } } }, "AttachmentDTO": { "properties": { "type": { "type": "string" }, "fileName": { "type": "string" }, "updatedAt": { "type": "string" }, "format": { "type": "string" }, "uuid": { "type": "string", "format": "uuid" }, "url": { "type": "string" } } }, "PaymentResponseList": { "type": "array", "items": { "$ref": "#/components/schemas/PaymentResponse" }, "properties": { "last": { "$ref": "#/components/schemas/PaymentResponse" }, "first": { "$ref": "#/components/schemas/PaymentResponse" }, "empty": { "type": "boolean" } } }, "InternalUser": { "properties": { "username": { "type": "string" }, "location": { "$ref": "#/components/schemas/InternalLocation" }, "taxIdentifier": { "type": "string" }, "userFullName": { "type": "string" }, "uuid": { "type": "string" }, "role": { "type": "string" }, "status": { "type": "string" }, "erpId": { "type": "string" } } }, "CreationGroupRequest": { "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "Attachment": { "properties": { "originalId": { "type": "integer" }, "fileName": { "type": "string" }, "entityTypeName": { "type": "string" }, "entityId": { "type": "integer" }, "updatedBy": { "type": "integer" }, "createdBy": { "type": "integer" }, "uuid": { "type": "string", "format": "uuid" }, "status": { "type": "integer", "format": "int32" }, "type": { "type": "integer", "format": "int32" }, "validationStatus": { "type": "string" }, "preSignedUrl": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "fileFormat": { "type": "string" }, "updatedAt": { "type": "string", "format": "date-time" }, "subtypeName": { "type": "string" } } }, "LabelPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/LabelV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "PageableObject": { "properties": { "pageSize": { "type": "integer", "format": "int32" }, "paged": { "type": "boolean" }, "unpaged": { "type": "boolean" }, "pageNumber": { "type": "integer", "format": "int32" }, "offset": { "type": "integer", "format": "int64" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "Location": { "properties": { "name": { "type": "string" }, "uuid": { "type": "string" } } }, "GroupV2": { "properties": { "name": { "type": "string", "description": "Name of the group" }, "uuid": { "type": "string", "description": "UUID of the group" } } }, "InvoicePage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/InvoiceV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "TransactionCardV2": { "properties": { "claraStatus": { "type": "string", "description": "Status of the card" }, "lockCode": { "type": "string" }, "threshold": { "type": "number", "description": "Threshold for the card", "format": "float" }, "alias": { "type": "string", "description": "Alias or nickname for the card" }, "periodicity": { "type": "string", "description": "Periodicity of the card" }, "maskedPan": { "type": "string", "description": "Card number" }, "type": { "type": "string", "description": "Type of the card" }, "user": { "description": "User of the card", "$ref": "#/components/schemas/InternalUser" }, "brand": { "type": "string", "description": "Periodicity of the card" }, "status": { "type": "string", "description": "Status of the card" }, "uuid": { "type": "string", "description": "UUID of the card" } } }, "InternalLocation": { "properties": { "name": { "type": "string" }, "uuid": { "type": "string" } } }, "SortObject": { "properties": { "ignoreCase": { "type": "boolean" }, "property": { "type": "string" }, "direction": { "type": "string" }, "nullHandling": { "type": "string" }, "ascending": { "type": "boolean" } } }, "PaymentPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/Payment" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "Tax": { "properties": { "retained": { "$ref": "#/components/schemas/Retained" }, "transferred": { "$ref": "#/components/schemas/Transferred" } } }, "Issuer": { "properties": { "businessName": { "type": "string" }, "rfc": { "type": "string" } } }, "BoletoRequest": { "properties": { "digitableLine": { "type": "string", "description": "Number sequence that describes the payment. If both are sent, barcode is taken into account.", "example": "00193373700000001000500940144816060680935031" }, "externalId": { "type": "string", "description": "External Id of the optional boleto", "example": 4567 }, "barcode": { "type": "string", "description": "Bar code number that describes the payment. If both are sent, barcode is taken into account.", "example": "00190500954014481606906809350314337370000000100" } } }, "InternalLabel": { "properties": { "name": { "type": "string" }, "uuid": { "type": "string" }, "active": { "type": "boolean" } } }, "LabelV2": { "properties": { "name": { "type": "string" }, "uuid": { "type": "string" }, "active": { "type": "boolean" } } }, "TransactionPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/TransactionV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "TransactionV2": { "properties": { "merchant": { "$ref": "#/components/schemas/Merchant" }, "lastUpdate": { "type": "string" }, "operationDate": { "type": "string", "description": "Operation date of the transaction", "format": "date" }, "invoices": { "type": "array", "items": { "$ref": "#/components/schemas/InvoiceV2" } }, "originalAmount": { "$ref": "#/components/schemas/Amount" }, "hasReceipt": { "type": "boolean" }, "card": { "description": "Card used in the transaction", "$ref": "#/components/schemas/TransactionCardV2" }, "bankConcept": { "$ref": "#/components/schemas/BankConcept" }, "accountingDate": { "type": "string", "description": "Accounting date of the transaction", "format": "date" }, "status": { "type": "string", "description": "Transaction operation status. Values include 'AU' for Pending and 'OP' for Authorized transactions." }, "amount": { "$ref": "#/components/schemas/Amount" }, "type": { "type": "string", "description": "Type of the transaction" }, "uuid": { "type": "string", "description": "UUID of the transaction" }, "authorizationNumber": { "type": "string", "description": "Authorization Number" }, "attachments": { "type": "array", "items": { "$ref": "#/components/schemas/InternalAttachment" } }, "label": { "type": "string", "description": "Transaction description" }, "hasInvoice": { "type": "boolean" }, "comment": { "type": "string", "description": "Comment associated with the transaction" }, "labels": { "type": "array", "items": { "$ref": "#/components/schemas/InternalLabel" } }, "billingStatement": { "$ref": "#/components/schemas/BillingStatementV2" } } }, "CardPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/CardV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "LabelsRequest": { "required": [ "names" ], "properties": { "names": { "type": "array", "items": { "type": "string" } } } }, "BillingStatementDetailsV2": { "properties": { "dueDate": { "type": "string", "description": "The due date from the billing statement" }, "start": { "type": "string", "description": "The starting date from the billing statement" }, "transactionsTotalAmount": { "type": "number", "description": "The sum of transactions being shown" }, "numberOfTransactions": { "type": "integer", "description": "The total of transactions being shown", "format": "int32" }, "transactions": { "type": "array", "description": "The list of transactions", "items": { "$ref": "#/components/schemas/TransactionV2" } }, "end": { "type": "string", "description": "The ending date from the billing statement" } } }, "UserCard": { "properties": { "claraStatus": { "type": "string", "description": "Status of the card" }, "threshold": { "type": "number", "description": "Threshold for the card", "format": "float" }, "alias": { "type": "string", "description": "Alias or nickname for the card" }, "periodicity": { "type": "string", "description": "Periodicity of the card" }, "maskedPan": { "type": "string", "description": "Card number" }, "type": { "type": "string", "description": "Type of the card" }, "uuid": { "type": "string", "description": "UUID of the card" }, "brand": { "type": "string", "description": "Periodicity of the card" } } }, "PaymentRequest": { "required": [ "boletos" ], "properties": { "boletos": { "type": "array", "description": "List of boletos to pay", "items": { "$ref": "#/components/schemas/BoletoRequest" } } } }, "Transferred": { "properties": { "iva": { "type": "number" }, "ieps": { "type": "number" } } }, "LocationV2": { "properties": { "name": { "type": "string", "description": "Name of the location" }, "uuid": { "type": "string", "description": "UUID of the location" } } }, "CreationCardRequest": { "required": [ "alias", "businessType", "periodicityType", "threshold", "type", "userUUID" ], "properties": { "type": { "type": "integer", "format": "int32" }, "threshold": { "type": "number", "format": "double" }, "alias": { "type": "string" }, "businessType": { "type": "integer", "format": "int32" }, "userUUID": { "type": "string", "format": "uuid" }, "periodicityType": { "type": "integer", "format": "int32" } } }, "UpdateCardThresholdRequest": { "required": [ "threshold" ], "properties": { "threshold": { "type": "number", "format": "double" } } }, "ListTransactionAttachmentsDTO": { "type": "array", "items": { "$ref": "#/components/schemas/Attachment" }, "properties": { "last": { "$ref": "#/components/schemas/Attachment" }, "first": { "$ref": "#/components/schemas/Attachment" }, "empty": { "type": "boolean" } } }, "UpdateLabelRequest": { "required": [ "labelName" ], "properties": { "labelName": { "type": "string" } } }, "CardV2": { "properties": { "claraStatus": { "type": "string", "description": "Status of the card" }, "lockCode": { "type": "string" }, "threshold": { "type": "number", "description": "Threshold for the card", "format": "float" }, "alias": { "type": "string", "description": "Alias or nickname for the card" }, "periodicity": { "type": "string", "description": "Periodicity of the card" }, "maskedPan": { "type": "string", "description": "Card number" }, "type": { "type": "string", "description": "Type of the card" }, "user": { "description": "User of the card", "$ref": "#/components/schemas/InternalUser" }, "brand": { "type": "string", "description": "Periodicity of the card" }, "status": { "type": "string", "description": "Status of the card" }, "uuid": { "type": "string", "description": "UUID of the card" } } }, "InvoiceV2": { "properties": { "tax": { "$ref": "#/components/schemas/Tax" }, "xmlCode": { "type": "string" }, "issuer": { "$ref": "#/components/schemas/Issuer" }, "xmlStatus": { "type": "string" }, "invoiceNumber": { "type": "string", "description": "Sequential number of the invoice" }, "taxRegime": { "type": "string", "description": "Fiscal regime under which the invoice is issued" }, "taxReceipts": { "$ref": "#/components/schemas/TaxReceipts" }, "invoiceId": { "type": "string", "description": "Unique Invoice ID identifier for the invoice" }, "amount": { "$ref": "#/components/schemas/Amount" }, "documentDate": { "type": "string", "description": "Date when the document was issued" } } }, "PaymentResponse": { "properties": { "externalId": { "type": "string", "description": "External Id of the optional boleto", "example": 4567 }, "barcode": { "type": "string", "description": "Bar code number that describes the payment", "example": "00190500954014481606906809350314337370000000100" }, "batchId": { "type": "string", "description": "Id of the batchId of all these payments", "example": "a0c82a20-ac09-4cfd-b429-d0623585911e" }, "digitableLine": { "type": "string", "description": "Number sequence that describes the payment", "example": "00193373700000001000500940144816060680935031" }, "id": { "type": "string", "description": "Id of the payment", "example": "9e52e1b3-e846-4bb5-8439-2430af8c3cff" }, "errorMessage": { "type": "string", "description": "Error message of the processing of the payment", "example": "Digitable line or barcode not found" }, "status": { "type": "string", "description": "Status of the payment", "enum": [ "SENT", "CREATED", "PROCESSING", "SETTLED", "PAID", "CANCELLED", "ERROR", "INVALID" ], "example": "SENT" } } }, "InternalUserV2": { "properties": { "username": { "type": "string" }, "location": { "$ref": "#/components/schemas/Location" }, "taxIdentifier": { "type": "string" }, "userFullName": { "type": "string" }, "uuid": { "type": "string" }, "role": { "type": "string" }, "status": { "type": "string" }, "erpId": { "type": "string" } } }, "BillingStatementV2": { "properties": { "dueDate": { "type": "string" }, "end": { "type": "string" }, "start": { "type": "string" } } }, "Payment": { "properties": { "errorCode": { "type": "string", "description": "Error code of the processing of the payment", "example": 500 }, "externalId": { "type": "string", "description": "External Id of the optional boleto", "example": 4567 }, "companyUuid": { "type": "string", "description": "Unique 32 characters identifier from the company in Clara", "format": "uuid", "example": "1b9d6bcd-bbfd-4b2d-9b5d-ab8dfbbd4bed" }, "accountId": { "type": "string", "description": "Unique 8 digits identifier from the company digital principal account", "example": 51702669 }, "digitableLine": { "type": "string", "description": "Number sequence that describes the payment", "example": "00193373700000001000500940144816060680935031" }, "errorMessage": { "type": "string", "description": "Error message of the processing of the payment", "example": "Digitable line or barcode not found" }, "status": { "type": "string", "description": "Status of the payment", "enum": [ "SENT", "CREATED", "PROCESSING", "SETTLED", "PAID", "CANCELLED", "ERROR", "INVALID" ], "example": "PAID" }, "beneficiaryName": { "type": "string", "description": "Name of the beneficiary", "example": "AYMORE CREDITO, FINANCIAMENTO E INV S.AJ" }, "beneficiaryDocumentNumber": { "type": "string", "description": "Document number of the beneficiary", "example": 7707650000110 }, "timestamp": { "type": "string", "description": "Timestamp of the creation of the payment", "format": "date-time", "example": "2024-08-25T15:00:14.04001" }, "transactionId": { "type": "string", "description": "The transaction ID related to the receipt", "example": 3057805688 }, "batchId": { "type": "string", "description": "Id of the batchId of all these payments", "example": "a0c82a20-ac09-4cfd-b429-d0623585911e" }, "id": { "type": "string", "description": "Id of the payment", "example": "9e52e1b3-e846-4bb5-8439-2430af8c3cff" }, "barcode": { "type": "string", "description": "Bar code number that describes the payment", "example": "00190500954014481606906809350314337370000000100" }, "updateDate": { "type": "string", "description": "Date of the last update of the payment", "format": "date-time", "example": "2024-08-26T14:00:14.04001" }, "paymentDatetime": { "type": "string", "description": "Payment date and time", "format": "date-time", "example": "2024-09-05T14:04:56.283Z" } } }, "UserV2": { "properties": { "erpId": { "type": "string", "description": "ERP ID of the user" }, "cards": { "type": "array", "items": { "$ref": "#/components/schemas/UserCard" } }, "location": { "description": "Location associated with the user", "$ref": "#/components/schemas/LocationV2" }, "taxIdentifier": { "type": "string", "description": "Tax identifier of the user" }, "userFullName": { "type": "string", "description": "Full name of the user" }, "manager": { "$ref": "#/components/schemas/InternalUserV2" }, "groups": { "type": "array", "items": { "$ref": "#/components/schemas/GroupV2" } }, "uuid": { "type": "string", "description": "UUID of the user" }, "username": { "type": "string", "description": "Username of the user" }, "status": { "type": "string", "description": "Status of the user" }, "role": { "type": "string", "description": "Role information of the user" } } }, "Amount": { "properties": { "total": { "type": "number" }, "subTotal": { "type": "number" }, "currency": { "type": "string" } } }, "GroupPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/GroupV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "Retained": { "properties": { "isr": { "type": "number" }, "iva": { "type": "number" }, "ieps": { "type": "number" } } }, "InternalAttachment": { "properties": { "type": { "type": "string" }, "fileName": { "type": "string" }, "uuid": { "type": "string", "format": "uuid" }, "updatedAt": { "type": "string" }, "preSignedUrl": { "type": "string" } } }, "UpdateGroupRequest": { "required": [ "managerUUID", "name", "status", "threshold", "uuid" ], "properties": { "name": { "type": "string" }, "threshold": { "type": "number", "format": "double" }, "uuid": { "type": "string", "format": "uuid" }, "status": { "type": "integer", "format": "int32" }, "managerUUID": { "type": "string", "format": "uuid" } } }, "CreationGroupResponse": { "properties": { "uuid": { "type": "string", "format": "uuid" } } }, "UserPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/UserV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "LocationPage": { "properties": { "content": { "type": "array", "items": { "$ref": "#/components/schemas/LocationV2" } }, "numberOfElements": { "type": "integer", "format": "int32" }, "last": { "type": "boolean" }, "pageable": { "$ref": "#/components/schemas/PageableObject" }, "size": { "type": "integer", "format": "int32" }, "totalElements": { "type": "integer", "format": "int64" }, "number": { "type": "integer", "format": "int32" }, "first": { "type": "boolean" }, "totalPages": { "type": "integer", "format": "int32" }, "empty": { "type": "boolean" }, "sort": { "type": "array", "items": { "$ref": "#/components/schemas/SortObject" } } } }, "ToggleCardLockRequest": { "required": [ "locked" ], "properties": { "locked": { "type": "boolean" } } }, "TaxReceipts": { "properties": { "paymentMethod": { "type": "string" }, "cfdi": { "type": "string" } } }, "BankConcept": { "properties": { "description": { "type": "string" }, "number": { "type": "string" } } }, "Merchant": { "properties": { "description": { "type": "string" }, "category": { "$ref": "#/components/schemas/Category" }, "code": { "type": "string" }, "commerceName": { "type": "string" } } }, "UserResponse": { "properties": { "description": { "type": "string" } } } } } }