Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

HTTP Basic authentication with Facturama username and password.

Body

application/json

CFDI to create

Issuance CFDI without requiring Client and Product catalogs

ExpeditionPlace
string
required

ExpeditionPlace: Required attribute to include the postal code of the place of issuance of the voucher (headquarters or branch address)

Minimum string length: 1
CfdiType
string
required

VoucherType: Required attribute to express the key of the tax voucher effect for the issuing taxpayer

Minimum string length: 1
Pattern: I|E|T|N|P
Receiver
object
required

Client to whom the CFDI will be issued, Required Attribute

NameId
integer<int32> | null

Atributo para especificar el nombre que se establecera en el pdf (default 1 = factura) [ Vea la documentación de "Nombres del CFDI" ]

Date
string<date-time> | null

Date: Required attribute for the expression of the date and time of issuance of the Digital Tax Voucher via Internet. Expressed in the form YYYY-MM-DDThh:mm:ss and must correspond to the local time where the voucher is issued

Pattern: ^([\+-]?\d{4}(?!\d{2}\b))((-?)((0[1-9]|1[0-2])(\3([12]\d|0[1-9]|3[01]))?|W([0-4]\d|5[0-2])(-?[1-7])?|(00[1-9]|0[1-9]\d|[12]\d{2}|3([0-5]\d|6[1-6])))([T\s]((([01]\d|2[0-3])((:?)[0-5]\d)?|24\:?00)([\.,]\d+(?!:))?)?(\17[0-5]\d([\.,]\d+)?)?([zZ]|([\+-])([01]\d|2[0-3]):?([0-5]\d)?)?)?)?$
Serie
string | null

Series: Optional attribute to specify the series for the taxpayer's internal control. This attribute accepts a character string.

Required string length: 1 - 25
Pattern: [^|]{1,25}
PaymentAccountNumber
string | null

Optional attribute to include at least the last four digits of the account number used for payment....

Required string length: 4
Pattern: ^\d{1,4}?$
CurrencyExchangeRate
number<decimal> | null

ExchangeRate: Conditional attribute to represent the FIX exchange rate per the currency used. Required when the currency key is other than MXN and XXX. The value must reflect the number of Mexican pesos equivalent to one unit of the currency indicated in the currency attribute. If the value is outside the applicable percentage for the currency from the c_Moneda catalog, the issuer must obtain from the PAC that will stamp the CFDI, in a non-automatic manner, a confirmation key to ratify that the value is correct and include that key in the Confirmacion attribute

Required range: x >= 0.000001
Currency
string | null

Currency: Required attribute to identify the currency key used to express amounts; when using the national currency, MXN is recorded. Per ISO 4217 specification

Required string length: 3
Confirmation
string | null

Confirmation: Conditional attribute to register the confirmation key provided by the PAC to issue the voucher with large amounts, with an exchange rate outside the established range, or both cases. Required when an exchange rate or total outside the established range is recorded.

Required string length: 5
Pattern: [a-zA-Z0-9]{5}
Exportation
string | null

Export: Required attribute to express whether the voucher covers an export operation. Selected from the SAT catalog 01|02|03|04

Pattern: 0[1234]
PaymentConditions
string | null

PaymentConditions: Conditional attribute to express the commercial conditions applicable for the payment of the digital tax voucher via Internet. This attribute may be conditioned by attributes or complements

Pattern: [^|]{1,100}
Relations
object | null

Related CFDIs, used for credit notes, etc.

GlobalInformation
object | null

Global Information Node

IsInvoice
boolean | null
IdCfdi
string | null

Invoice Id with Status invalid | unanswered (invalid record without stamp due to some intermittence during operations), if IdCfdi parameter contains a value the folio of the found record is reused, otherwise a new one is created.

Folio
string | null

Folio: Optional attribute for the taxpayer's internal control that expresses the voucher folio, accepts a string of 1 to 40 characters.

Required string length: 1 - 40
Pattern: [^|]{1,40}
PaymentForm
string | null

PaymentForm: Conditional attribute to express the payment form key for the goods or services covered by the voucher.

Pattern: 01|02|03|04|05|06|08|12|13|14|15|17|23|24|25|26|27|28|29|30|31|99
PaymentMethod
string | null

PaymentMethod: Conditional attribute to specify the payment method key applicable to this digital tax voucher via Internet, per Article 29-A section VII items a and b of the CFF. Payment methods include: PPD, PUE

Pattern: PUE|PPD
Items
object[] | null

Required node to list the concepts covered by the voucher.

Complemento
object | null

CFDI Complement

Observations
string | null

Non-fiscal PDF description

OrderNumber
string | null

Order number, non-fiscal property (optional)

Maximum string length: 100
PaymentBankName
string | null

Bank name, non-fiscal property (optional)

Maximum string length: 50
IdTaxEntityBankAccounts
string | null

Id of the bank account related to the tax entity

Response

200 - application/json

CFDI detail

Body of the result of a CFDI query.

Id
string | null

Unique CFDI identifier.

CfdiType
string | null

Type of tax voucher effect for the issuing taxpayer: income, expense, or transfer.

Type
string | null

Voucher type per SAT catalog.

Serie
string | null

Series number in the taxpayer's internal control.

Folio
string | null

Folio number in the taxpayer's internal control.

Date
string | null

Date and time of issuance of the tax voucher.

CertNumber
string | null

Certificate number.

PaymentTerms
string | null

Payment form.

PaymentConditions
string | null

Commercial conditions applicable for the payment of the digital tax voucher via Internet.

PaymentMethod
string | null

Payment method for the goods or services covered by the voucher. Payment methods include: check, credit or debit card, account deposit, etc.

PaymentAccountNumber
string | null

Includes at least the last four digits of the account number used for payment.

PaymentBankName
string | null

Name of the bank where the payment was made.

ExpeditionPlace
string | null

Place of issuance of the voucher.

ExchangeRate
number<decimal> | null

Exchange rate per the currency used.

Currency
string | null

Currency used to express amounts.

Subtotal
number<decimal>

Represents the sum of amounts before discounts and taxes.

Discount
number<decimal> | null

Represents the total amount of applicable discounts before taxes.

Total
number<decimal>

Represents the sum of the subtotal, minus applicable discounts, plus transferred taxes, minus withheld taxes.

Observations
string | null

Non-fiscal observations of the invoice.

OrderNumber
string | null

Non-fiscal observations of the invoice.

Issuer
object | null

Node containing the issuer detail.

Receiver
object | null

Node containing the receiver detail.

Items
object[] | null

Node containing the line items detail.

Taxes
object[] | null

Node containing the tax detail.

Complement
object | null

Node containing extension complements defined by SAT.

Status
string | null

Invoice status.

OriginalString
string | null

Original string.

IsPayableBy
string | null

Determines whether this invoice can be paid.