Crear Factura de Recepción de Pago¶
Crea un comprobante fiscal de Comprobantes de Pago.
Definición¶
POST https://api.avanto.mx/v2/sales
Información
Los atributos marcados con son requeridos.
Importante
Únicamente los comprobantes con método de pago "PPD - Pago Parcialidades o Diferido"
Cuerpo de solicitud¶
| Propiedad | Tipo | Default | Descripción |
|---|---|---|---|
| company_subsidiary_id | int | 0 | Sucursal de empresa emisora |
| accounting_effect | char | "P" | Efecto contable: "I" - Ingreso "E" - Egreso "P" - Pago "T" - Traslado |
| subsidiary_id | int | 0 | ID de la sucursal del cliente (receptor) |
| cfdi_regimenfiscal | varchar | "" | Emisor.RegimenFiscal |
| cfdi_usocfdi | varchar | "" | Receptor.UsoCFDI |
| emitted | datetime | datetime() | Fecha y hora de emisión |
| carrier | varchar | "" | Transportista: "FedEx", "UPS", "DHL" (requiere catálogo) |
| shipping | varchar | "" | Dato de envío |
| assigned_to | int | 0 | Asignado a/ Vendedor (ID de usuario) |
| currency_id | int | 0 | ID de la moneda |
| exchange_rate | decimal | 0.000 | Tipo de cambio |
| notes | text | "" | Notas adicionales |
| tips | decimal | 0.000 | Importe de servicios adicionales. |
| balance | decimal | 0.000 | Saldo restante |
| cfdiPayments | Object | ||
| cfdiPayments.fechapago | datetime | "" | Fecha del pago |
| cfdiPayments.formadepagop | varchar | "" | Forma de pago |
| cfdiPayments.monedap | varchar | "" | Moneda "MXN", "USD" |
| cfdiPayments.tipocambiop | decimal | "1" | Tipo de cambio |
| cfdiPayments.monto | decimal | "0.0000" | Monto |
| cfdiPayments.numoperacion | varchar | "" | Número de operación |
| cfdiPayments.ctaordenante | varchar | "" | Cuenta bancaria del ordenante |
| cfdiPayments.rfcemisorctaben | varchar | "" | RFC del emisor cuenta |
| cfdiPayments.ctabeneficiario | varchar | "" | Cuenta bancaria del beneficiario |
| cfdiPayments.tipocadpago | varchar | "" | Tipo de cadena de pago |
| cfdiPayments.certpago | text | "" | Certificado de pago |
| cfdiPayments.cadpago | text | "" | Cadena original del pago |
| cfdiPayments.sellopago | text | "" | Sello digital |
| cfdiPayments.relateddocs | Object | ||
| cfdiPayments.relateddocs.iddocumento | text | "" | UUID del documento relacionado |
| cfdiPayments.relateddocs.folio | text | "" | Folio del comprobante |
| cfdiPayments.relateddocs.serie | teb xt | "" | Serie del comprobante |
| cfdiPayments.relateddocs.monedadr | text | "" | Moneda |
| cfdiPayments.relateddocs.tipocambiodr | text | "" | Tipo de cambio |
| cfdiPayments.relateddocs.numparcialidad | int | 0 | Número de parcialidades |
| cfdiPayments.relateddocs.impsaldoant | decimal | 0.000 | Importe de saldo anterior |
| cfdiPayments.relateddocs.impsaldopagado | decimal | 0.000 | Importe de saldo pagado |
| cfdiPayments.relateddocs.impsaldoinsoluto | decimal | 0.000 | Importe de saldo insoluto |
| cfdiPayments.relateddocs.cfdiImpuestosdr * | array | Array de Impuestos del documento relacionado | |
| cfdiPayments.relateddocs.cfdiImpuestosdr.basedr | decimal | 0.000 | Base del documento relacionado |
| cfdiPayments.relateddocs.cfdiImpuestosdr.impuestodr | string | "" | Impuesto del documento relacionado (Catálogo del SAT) |
| cfdiPayments.relateddocs.cfdiImpuestosdr.tasaocuotadr | decimal | 0.000 | Tasa o cuota del documento relacionado |
| cfdiPayments.relateddocs.cfdiImpuestosdr.tipofactordr | string | "" | Tipo de factor del Documento Relacionado "Tasa", "Cuota" |
| cfdiPayments.relateddocs.cfdiImpuestosdr.importedr | string | "" | Importe del documento relacionado |
| cfdiPayments.relateddocs.cfdiImpuestosdr.tipo | int | 1 | Tipo de impuesto del documento relacionado 1. Traslado, 2. Retención |
Atención
- Es obligatorio que la factura a relacionar tenga como método de pago "PPD".
- Se requiere al menos dar de alta un pago para poder generar el comprobante correctamente.
- Se requiere al menos dar de alta un documento relacionado al pago para poder generar el comprobante correctamente.
Ejemplo¶
{
"company_subsidiary_id": 1,
"accounting_effect": "P",
"subsidiary_id": 48,
"cfdi_regimenfiscal": "601",
"cfdiPayments": [
{
"fechapago": "2022-01-01T10:00:00",
"formadepagop": "01",
"monedap": "MXN",
"tipocambiop": 1,
"relateddocs": [
{
"iddocumento": "70B66071-1E4C-5573-BFD8-73F6145D0EBD",
"folio": "12",
"serie": "A",
"monedadr": "MXN",
"tipocambiodr": 1,
"objetoimpdr": "02",
"impsaldoant": 1774.57,
"imppagado": 1774.57,
"impsaldoinsoluto": 0,
"numparcialidad": 1,
"cfdiImpuestosdr": [
{
"basedr": 1529.80,
"impuestodr": "002",
"tipofactordr": "Tasa",
"tasaocuotadr": 0.16,
"importedr": 244.768,
"tipo": 1
}
]
}
]
}
]
}
Ejemplo de Respuesta¶
La respuesta en formato: application/json, text/json.
{
"accounting_effect": "P",
"subsidiary_id": 43,
"currency_id": 0,
"exchange_rate": 0,
"items": 0,
"pieces": "0.000000",
"subtotal": 0,
"discount": 0,
"subtotal_discount": "0.0000",
"withheld_taxes_total": "0.0000",
"transferred_taxes_total": "0.0000",
"total": 0,
"days_to_pay": 0,
"receivable": 1,
"deposited": 0,
"canceled": 0,
"tips": "0.0000",
"active": 1,
"company_subsidiary_id": 1,
"payment_options": "01",
"payment_method": "PPD",
"folio": 0,
"serial_number": "",
"emitted": "2022-09-11T13:45:42",
"terms_conditions": "",
"carrier": "",
"shipping": "",
"notes": "",
"received": "2022-09-11",
"id": 449
}
Si se quiere ver todos los objetos relacionados al comprobante. Se necesita hacer la solicitud de la siguiente manera:
curl --request POST \
--url 'https://api.avanto.mx/v2/sales?expand=soldItems,cfdiPayments' \
--header 'authorization: Bearer [Access-Token]' \
{
"accounting_effect": "P",
"subsidiary_id": 43,
"currency_id": 0,
"exchange_rate": 0,
"items": 0,
"pieces": "0.000000",
"subtotal": 0,
"discount": 0,
"subtotal_discount": "0.0000",
"withheld_taxes_total": "0.0000",
"transferred_taxes_total": "0.0000",
"total": 0,
"days_to_pay": 0,
"receivable": 1,
"deposited": 0,
"canceled": 0,
"tips": "0.0000",
"active": 1,
"company_subsidiary_id": 1,
"payment_options": "01",
"payment_method": "PPD",
"folio": 0,
"serial_number": "",
"emitted": "2022-09-11T14:04:48",
"terms_conditions": "",
"carrier": "",
"shipping": "",
"notes": "",
"received": "2022-09-11",
"id": 450,
"soldItems": [
{
"quantity": "1.000000",
"unit_of_measure": "",
"code": "",
"description": "Pago",
"unit_price": "0.0000",
"amount": "0.0000",
"discount": "0.0000",
"non_taxable": 0,
"cfdi_claveprodserv": "84111506",
"cfdi_claveunidad": "ACT",
"cfdi_cuentapredial": "",
"notes": "",
"created_at": "2022-09-11 14:04:48"
}
],
"cfdiPayments": [
{
"fechapago": "2022-01-01 00:00:00",
"formadepagop": "01",
"monedap": "MXN",
"tipocambiop": "1.000000",
"monto": "100.000000",
"numoperacion": "",
"rfcemisorctaord": "",
"nombancoordext": "",
"ctaordenante": "",
"rfcemisorctaben": "",
"ctabeneficiario": "",
"tipocadpago": "",
"certpago": "",
"cadpago": "",
"sellopago": "",
"active": 1,
"created_at": "2022-09-11 14:04:48",
"relateddocs": [
{
"iddocumento": "F7F84A31-3F53-4776-AF38-137E28B7CFB5",
"serie": "a",
"folio": "12",
"monedadr": "MXN",
"tipocambiodr": "1.000000",
"metododepagodr": "PUE",
"numparcialidad": 1,
"impsaldoant": "100.000000",
"imppagado": "100.000000",
"impsaldoinsoluto": "0.000000",
"active": 1,
"created_at": "2022-09-11 14:04:48"
}
],
"cfdiImpuestosp": [
{
"basedr": 100,
"impuestodr": "002",
"tasaocuotadr": 0.16,
"tipofactordr": "Tasa",
"importedr": "16",
"tipo": 1
}
]
}
],
"cfdi_pagos_totales": [
{
"id": 1,
"sale_id": 17339,
"totalretencionesiva": null,
"totalretencionesisr": null,
"totalretencionesieps": null,
"totaltrasladosbaseiva16": 100.0000,
"totaltrasladosimpuestoiva16": 16.0000,
"totaltrasladosbaseiva8": null,
"totaltrasladosimpuestoiva8": null,
"totaltrasladosbaseiva0": null,
"totaltrasladosimpuestosiva0": null,
"totaltrasladosbaseivaexento": null,
"montototalpagos": 100.0000
}
]
}