Crear Factura de Egreso¶
Crea un comprobante fiscal de Egreso (Nota de crédito).
Definición¶
POST https://api.avanto.mx/v2/sales
Con Cliente existente¶
Cuerpo de solicitud¶
| Argumento | Tipo | Default | Descripción |
|---|---|---|---|
| company_subsidiary_id | integer | 0 | Sucursal de empresa emisora |
| accounting_effect | string | "I" | Efecto contable: "I" - Ingreso |
| subsidiary_id | integer | 0 | ID de la sucursal del cliente (receptor) |
| payment_method | string | "PUE" | Metodo de pago: "PUE" - Pago en una sola exhibición "PPD" - Pago en parcialidades o diferido |
| payment_options | string | "99" | Forma de pago: "99" - Por definir "01" - Efectivo "02" - Cheque nominativo, etc. |
| cfdi_regimenfiscal | string | "" | Régimen Fiscal del emisor (Emisor.RegimenFiscal) |
| cfdi_exportacion | string | "01" | Cfdi Exportación "01" - No aplica |
| emitted | datetime | datetime | Fecha y hora de emisión; se expresa en el formato AAAA-MM-DDThh:mm :ss |
| carrier | string | "" | Transportista: "FedEx", "UPS", "DHL" (requiere catálogo) |
| shipping | string | "" | Dato de envío |
| assigned_to | integer | 1 | Usuario Asignado. |
| currency_code | string | "MXN" | Código de la moneda |
| exchange_rate | decimal | 0.0000 | Tipo de cambio |
| received | date | date | Fecha en que recibe el cliente este comprobante |
| days_to_pay | integer | 0 | Total de día de crédito |
| receivable | integer | 1 | Pendiente por cobrar: 0 - Cobrado 1 - PXC |
| date_of_payment | datetime | datetime | Fecha del cobro |
| deposited | integer | 0 | Depositado: 0 - No depositado 1 - Depositado |
| terms_conditions | string | "" | Condiciones de pago |
| notes | string | "" | Notas adicionales |
| tips | decimal | 0.0000 | Importe de servicios adicionales |
| cfdi_facactadquiriente | string | "" | Cfdi FactAtrAdquirente |
| sic_code | string | "" | RFC del cliente |
| customer_name | string | "" | Nombre del cliente (Customers.customer_name) |
| customer_email | string | "" | Correo electrónico del cliente (Customers.email) |
| cfdi_usocfdi | string | "" | Uso del CFDI (Receptor.UsoCFDI) |
| cfdi_domiciliofiscalreceptor | integer | "" | Domicilio fiscal receptor (Customers.Subsidiaries.bill_code) |
| cfdi_regimenfiscalreceptor | integer | "" | Regimen fiscal receptor (Customers.cfdi_regimenfiscalreceptor) |
| soldItems | Object | - | Productos del comprobante |
| soldItems.quantity | decimal | 0.0000 | Cantidad |
| soldItems.description | string | "" | Descripción del producto |
| soldItems.unit_price | decimal | 0.0000 | Precio unitario |
| soldItems.cfdi_objetoimp | string | "" | Objeto a impuestos. "01" - No objeto de impuesto "02" - Sí objeto de impuesto "03" - Sí objeto del impuesto y no obligado al desglose |
| soldItems.unit_of_measure | string | "" | Unidad de medida del producto (interna) |
| soldItems.code | string | "" | Código o clave del producto (interna) |
| soldItems.discount | decimal | 0.0000 | Monto de descuento |
| soldItems.non_taxable | tinyint | 0 | Exento o libre de impuestos: 0 - No exento 1 - Exento |
| soldItems.cfdi_claveprodserv | string | "01010101" | Clave del producto o servicio del catálogo del SAT |
| soldItems.cfdi_claveunidad | string | "H87" | Clave de unidad del catálogo del SAT |
| soldItems.cfdi_cuentapredial | string | "" | No. cuenta predial para el caso de recibos de arrendamiento |
| soldItems.notes | string | "" | Datos adicionales para imprimir en el comprobante junto al artículo |
| soldItems.taxes | Object | - | Impuestos |
| soldItems.taxes.tax_type | string | "" | Tipo de impuesto: "T. Traslado" "R. Retención" |
| soldItems.taxes.tax_name | string | "" | Nombre de impuesto: "002. IVA" "003. IEPS" "001. ISR" |
| soldItems.taxes.type_factor | string | "" | Tipo Factor: "Tasa", "Cuota", "Exento" |
| soldItems.taxes.tax_rate | decimal | 0.0000 | Tasa o cuota; un Porcentaje (p.ej: 0.16 para 16%) o un Importe |
| cfdiRelated | Objeto | - | Documentos relacionados |
| cfdiRelated.uuid | string | "" | UUID de la factura relacionada. |
Información
- Los campos marcados con son datos requeridos.
- Tome en cuenta que el valor de emitted no puede ser de hace más de 48 horas ni mayor a la fecha y hora de la Ciudad de México y es independiente a la fecha y hora de timbrado.
- Tipo de cambio es requerido si currency_code es diferente de "MXN".
- Los campos soldItems.cfdi_claveprodserv y soldItems.cfdi_claveunidad deben registrar por defecto el valor de “84111506” y “ACT”.
- El campo soldItems.quantity debe registar el valor "1".
- Si no se especifica el objeto soldItems.taxes, se supone un Traslado del 16% de IVA directo al importe de base.
- Sólo debe existir un concepto en éste comprobante.
Atención
- La información enviada sobre el cliente será actualizada en la base de datos.
- Se requiere al menos dar de alta un producto/servicio para poder generar el comprobante correctamente.
Payload¶
{
"company_subsidiary_id": 1,
"accounting_effect": "E",
"subsidiary_id": 48,
"payment_method": "01",
"payment_options": "PUE",
"cfdi_exportacion": "01",
"cfdi_regimenfiscal": "601",
"cfdi_usocfdi": "S01",
"soldItems": [
{
"quantity": 2,
"description": "Paquete de marcadores",
"unit_price": 100,
"discount": 20,
"cfdi_objetoimp": 01
}
],
"cfdiRelated": [
{
"uuid": "F7F84A31-3F53-4776-AF38-137E28B7CFB5"
}
]
}
Si se quiere ver todos los objetos relacionados al comprobante. Se necesita hacer la solicitud de la siguiente manera:
GET https://api.avanto.mx/v2/sales/106?company_subsidiary_id=1&expand=cfdidetails,soldItems,salesTaxes,cfdiRelated
Sin precargar Cliente¶
Cuerpo de solicitud¶
| Argumento | Tipo | Default | Descripción |
|---|---|---|---|
| company_subsidiary_id | integer | 0 | Sucursal de empresa emisora |
| accounting_effect | string | "I" | Efecto contable: "I" - Ingreso |
| payment_method | string | "PUE" | Metodo de pago: "PUE" - Pago en una sola exhibición "PPD" - Pago en parcialidades o diferido |
| payment_options | string | "99" | Forma de pago: "99" - Por definir "01" - Efectivo "02" - Cheque nominativo, etc. |
| cfdi_regimenfiscal | string | "" | Régimen Fiscal del emisor (Emisor.RegimenFiscal) |
| cfdi_exportacion | string | "01" | Cfdi Exportación "01" - No aplica |
| sic_code | string | "" | RFC del cliente |
| customer_name | string | "" | Nombre del cliente (Customers.customer_name) |
| customer_email | string | "" | Correo electrónico del cliente (Customers.email) |
| cfdi_usocfdi | string | "" | Uso del CFDI (Receptor.UsoCFDI) |
| cfdi_domiciliofiscalreceptor | integer | "" | Domicilio fiscal receptor (Customers.Subsidiaries.bill_code) |
| cfdi_regimenfiscalreceptor | integer | "" | Regimen fiscal receptor (Customers.cfdi_regimenfiscalreceptor) |
| subsidiary_id | integer | 0 | ID de la sucursal del cliente (receptor) |
| emitted | datetime | datetime | Fecha y hora de emisión; se expresa en el formato AAAA-MM-DDThh:mm :ss |
| carrier | string | "" | Transportista: "FedEx", "UPS", "DHL" (requiere catálogo) |
| shipping | string | "" | Dato de envío |
| assigned_to | integer | 1 | Usuario Asignado. |
| currency_code | string | "MXN" | Código de la moneda |
| exchange_rate | decimal | 0.0000 | Tipo de cambio |
| received | date | date | Fecha en que recibe el cliente este comprobante |
| days_to_pay | integer | 0 | Total de día de crédito |
| receivable | integer | 1 | Pendiente por cobrar: 0 - Cobrado 1 - PXC |
| date_of_payment | datetime | datetime | Fecha del cobro |
| deposited | integer | 0 | Depositado: 0 - No depositado 1 - Depositado |
| terms_conditions | string | "" | Condiciones de pago |
| notes | string | "" | Notas adicionales |
| tips | decimal | 0.0000 | Importe de servicios adicionales |
| cfdi_facactadquiriente | string | "" | Cfdi FactAtrAdquirente |
| soldItems | Object | - | Productos del comprobante |
| soldItems.quantity | decimal | 0.0000 | Cantidad |
| soldItems.description | string | "" | Descripción del producto |
| soldItems.unit_price | decimal | 0.0000 | Precio unitario |
| soldItems.cfdi_objetoimp | string | "" | Objeto a impuestos. "01" - No objeto de impuesto "02" - Sí objeto de impuesto "03" - Sí objeto del impuesto y no obligado al desglose |
| soldItems.unit_of_measure | string | "" | Unidad de medida del producto (interna) |
| soldItems.code | string | "" | Código o clave del producto (interna) |
| soldItems.discount | decimal | 0.0000 | Monto de descuento |
| soldItems.non_taxable | tinyint | 0 | Exento o libre de impuestos: 0 - No exento 1 - Exento |
| soldItems.cfdi_claveprodserv | string | "01010101" | Clave del producto o servicio del catálogo del SAT |
| soldItems.cfdi_claveunidad | string | "H87" | Clave de unidad del catálogo del SAT |
| soldItems.cfdi_cuentapredial | string | "" | No. cuenta predial para el caso de recibos de arrendamiento |
| soldItems.notes | string | "" | Datos adicionales para imprimir en el comprobante junto al artículo |
| soldItems.taxes | Object | - | Impuestos |
| soldItems.taxes.tax_type | string | "" | Tipo de impuesto: "T. Traslado" "R. Retención" |
| soldItems.taxes.tax_name | string | "" | Nombre de impuesto: "002. IVA" "003. IEPS" "001. ISR" |
| soldItems.taxes.type_factor | string | "" | Tipo Factor: "Tasa", "Cuota", "Exento" |
| soldItems.taxes.tax_rate | decimal | 0.0000 | Tasa o cuota; un Porcentaje (p.ej: 0.16 para 16%) o un Importe |
| cfdiRelated | Objeto | - | Documentos relacionados |
| cfdiRelated.uuid | string | "" | UUID de la factura relacionada. |
Payload¶
{
"company_subsidiary_id": 1,
"accounting_effect": "E",
"payment_method": "PUE",
"payment_options": "01",
"cfdi_regimenfiscal": "601",
"cfdi_exportacion": "01",
"sic_code": "SUL010720JN8",
"customer_name": "CESAR OSBALDO CRUZ SOLORZANO",
"customer_email": "[email protected]",
"cfdi_usocfdi": "S01",
"cfdi_domicilifiscalreceptor": "45638",
"cfdi_regimenfiscalreceptor": "605",
"soldItems": [
{
"quantity": 2,
"description": "Marcador de texto",
"unit_price": 100,
"discount": 20,
"cfdi_objetoimp": 01
}
],
"cfdiRelated": [
{
"uuid": "F7F84A31-3F53-4776-AF38-137E28B7CFB5"
}
]
}
Respuesta¶
La respuesta en formato: application/json, text/json.
{
"id": 49,
"company_subsidiary_id": 1,
"accounting_effect": "E",
"serial_number": "A",
"folio": 1,
"emitted": "2022-03-29 01:22:53",
"subsidiary_id": 49,
"carrier": "",
"shipping": "",
"currency_id": 7,
"exchange_rate": "1.0000",
"payment_options": "01",
"payment_method": "PUE",
"items": 1,
"pieces": "1.000000",
"subtotal": "1.0000",
"discount": "0.0000",
"subtotal_discount": "1.0000",
"withheld_taxes_total": "0.0000",
"transferred_taxes_total": "0.1600",
"total": "1.1600",
"received": "2022-03-29",
"days_to_pay": 0,
"receivable": 1,
"date_of_payment": "2022-03-29 00:00:00",
"deposited": 0,
"terms_conditions": "",
"canceled": 0,
"canceled_date": "1969-12-12 00:00:00",
"notes": "",
"tips": "0.0000",
"balance": null,
"active": 1,
"created_at": "2022-03-29 00:22:53"
}
Todos los datos completos del comprobante emitido:
{
"id": 49,
"company_subsidiary_id": 1,
"accounting_effect": "E",
"serial_number": "A",
"folio": 1,
"emitted": "2022-03-29 01:22:53",
"subsidiary_id": 49,
"carrier": "",
"shipping": "",
"currency_id": 7,
"exchange_rate": "1.0000",
"payment_options": "01",
"payment_method": "PUE",
"items": 1,
"pieces": "1.000000",
"subtotal": "1.0000",
"discount": "0.0000",
"subtotal_discount": "1.0000",
"withheld_taxes_total": "0.0000",
"transferred_taxes_total": "0.1600",
"total": "1.1600",
"received": "2022-03-29",
"days_to_pay": 0,
"receivable": 1,
"date_of_payment": "2022-03-29 00:00:00",
"deposited": 0,
"terms_conditions": "",
"canceled": 0,
"canceled_date": "1969-12-12 00:00:00",
"notes": "",
"tips": "0.0000",
"balance": null,
"active": 1,
"created_at": "2022-03-29 00:22:53",
"soldItems": [
{
"quantity": "1.000000",
"unit_of_measure": "Pieza",
"code": "",
"description": "Un producto de a peso",
"unit_price": "1.0000",
"amount": "1.0000",
"discount": "0.0000",
"non_taxable": 0,
"cfdi_claveprodserv": "01010101",
"cfdi_claveunidad": "H87",
"cfdi_cuentapredial": "",
"notes": "",
"created_at": "2022-03-29 00:23:52",
"taxes": [
{
"tax_type": "T",
"taxable_base": "1.0000",
"tax_name": "002",
"type_factor": "Tasa",
"tax_rate": "0.160000",
"amount": "0.1600",
"created_at": "2022-03-29 00:23:52"
}
]
}
],
"cfdidetails": {
"id": 49,
"sale_id": 49,
"cfdi_acuse_cancelado": "",
"cfdi_nocertificado": "20001000000300022815",
"cfdi_certificado": "MIIFxTCCA62gAwIBAgIUMjAwMDEwMDAwMDAzMDAwMjI4MTUwDQYJKoZIhvcNAQELBQAwggFmMSAwHgYDVQQDDBdBLkMuIDIgZGUgcHJ1ZWJhcyg0MDk2KTEvMC0GA1UECgwmU2VydmljaW8gZGUgQWRtaW5pc3RyYWNpw7NuIFRyaWJ1dGFyaWExODA2BgNVBAsML0FkbWluaXN0cmFjacOzbiBkZSBTZWd1cmlkYWQgZGUgbGEgSW5mb3JtYWNpw7NuMSkwJwYJKoZIhvcNAQkBFhphc2lzbmV0QHBydWViYXMuc2F0LmdvYi5teDEmMCQGA1UECQwdQXYuIEhpZGFsZ28gNzcsIENvbC4gR3VlcnJlcm8xDjAMBgNVBBEMBTA2MzAwMQswCQYDVQQGEwJNWDEZMBcGA1UECAwQRGlzdHJpdG8gRmVkZXJhbDESMBAGA1UEBwwJQ295b2Fjw6FuMRUwEwYDVQQtEwxTQVQ5NzA3MDFOTjMxITAfBgkqhkiG9w0BCQIMElJlc3BvbnNhYmxlOiBBQ0RNQTAeFw0xNjEwMjUyMTUyMTFaFw0yMDEwMjUyMTUyMTFaMIGxMRowGAYDVQQDExFDSU5ERU1FWCBTQSBERSBDVjEaMBgGA1UEKRMRQ0lOREVNRVggU0EgREUgQ1YxGjAYBgNVBAoTEUNJTkRFTUVYIFNBIERFIENWMSUwIwYDVQQtExxMQU43MDA4MTczUjUgLyBGVUFCNzcwMTE3QlhBMR4wHAYDVQQFExUgLyBGVUFCNzcwMTE3TURGUk5OMDkxFDASBgNVBAsUC1BydWViYV9DRkRJMIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAgvvCiCFDFVaYX7xdVRhp/38ULWto/LKDSZy1yrXKpaqFXqERJWF78YHKf3N5GBoXgzwFPuDX+5kvY5wtYNxx/Owu2shNZqFFh6EKsysQMeP5rz6kE1gFYenaPEUP9zj+h0bL3xR5aqoTsqGF24mKBLoiaK44pXBzGzgsxZishVJVM6XbzNJVonEUNbI25DhgWAd86f2aU3BmOH2K1RZx41dtTT56UsszJls4tPFODr/caWuZEuUvLp1M3nj7Dyu88mhD2f+1fA/g7kzcU/1tcpFXF/rIy93APvkU72jwvkrnprzs+SnG81+/F16ahuGsb2EZ88dKHwqxEkwzhMyTbQIDAQABox0wGzAMBgNVHRMBAf8EAjAAMAsGA1UdDwQEAwIGwDANBgkqhkiG9w0BAQsFAAOCAgEAJ/xkL8I+fpilZP+9aO8n93+20XxVomLJjeSL+Ng2ErL2GgatpLuN5JknFBkZAhxVIgMaTS23zzk1RLtRaYvH83lBH5E+M+kEjFGp14Fne1iV2Pm3vL4jeLmzHgY1Kf5HmeVrrp4PU7WQg16VpyHaJ/eonPNiEBUjcyQ1iFfkzJmnSJvDGtfQK2TiEolDJApYv0OWdm4is9Bsfi9j6lI9/T6MNZ+/LM2L/t72Vau4r7m94JDEzaO3A0wHAtQ97fjBfBiO5M8AEISAV7eZidIl3iaJJHkQbBYiiW2gikreUZKPUX0HmlnIqqQcBJhWKRu6Nqk6aZBTETLLpGrvF9OArV1JSsbdw/ZH+P88RAt5em5/gjwwtFlNHyiKG5w+UFpaZOK3gZP0su0sa6dlPeQ9EL4JlFkGqQCgSQ+NOsXqaOavgoP5VLykLwuGnwIUnuhBTVeDbzpgrg9LuF5dYp/zs+Y9ScJqe5VMAagLSYTShNtN8luV7LvxF9pgWwZdcM7lUwqJmUddCiZqdngg3vzTactMToG16gZA4CWnMgbU4E+r541+FNMpgAZNvs2CiW/eApfaaQojsZEAHDsDv4L5n3M1CC7fYjE/d61aSng1LaO6T1mh+dEfPvLzp7zyzz+UgWMhi5Cs4pcXx1eic5r7uxPoBwcCTt3YI1jKVVnV7/w=",
"cfdi_timbrado": 1,
"cfdi_fechatimbrado": "2022-03-29 00:49:17",
"cfdi_nocertificadosat": "20001000000300022323",
"cfdi_uuid": "2B9A36A6-D08D-45DB-B3DF-A43F485CD48F",
"cfdi_cadena_original": "||4.0|A|1|2022-03-29T01:22:53|01|20001000000300022815|1.00|MXN|1.16|I|PUE|77500|LAN7008173R5|CINDEMEX SA DE CV|601|UABF781203TU7|CHARLIE DAY|P01|01010101|1.000000|H87|Pieza|Un producto de a peso|1.0000|1.0000|1.0000|002|Tasa|0.160000|0.1600|002|Tasa|0.160000|0.16|0.16||",
"cfdi_sello": "YUL4xVkbLUOBZr81If0E2jNAjji6PeW0u+pRTMS9iXyjinmWXXFMOUWPMDiUShZf2VOJnZujZevmdkzqEGDiu7bkHMsWGtNzQ2nmR4K/PXl/adPnUKtnuGJRC8kvHf3fsmukKMF0H44HekHu2pHlwLuAfjy4CYCKTpxRnnN+hxkFwXOfhP+P5Jc8zpLT+cFUw1ZSSpv0yQJ4AEsYF+PdlS8X4b+7JeXFcxbtLGQ91kOKW3OuBcfBn+nxmPX7iZdHqt5CNFjLaBCM62tlv1Oi4kkCytOkU9GA4PTqiCN8f6o3YXcHduo+DgxHIE8P70oClqQ+TJYpIISMeU1A0/AYTQ==",
"cfdi_sellosat": "S8WeLRf2tvugckNmdt2YA8dF+OQWV7aux44/kY1G4XlUybovJWodwUVUUB7GlCNts2NmkZnUUgnKY16j775thCqSksPS+sAwkW4N8uQGSkfrQqLoQlr+Pl/o5TTPPzWNnEft59GZNOySE5cOMPdo0OEpnp+t2ZS1b42W+Tc4ODgr7WM3Z6dQhaaVDoPCmADFtTvFOdxw2vk29X1rPz3a72hKwiYwX7Wmljdfebe6n4qzlqHmet8uuMltZiGYGtZ7gg2TzLU/dkA5vbmOCjKyf5rlgU4HlfHqzn6+4B8j6PHrYu1kYbRKJnDHopTc/MFeTRUyzQIMWckCgMqo8PtoBA==",
"cfdi_lugarexpedicion": "77500",
"cfdi_confirmacion": "",
"cfdi_tiporelacion": "",
"cfdi_regimenfiscal": "601",
"cfdi_usocfdi": "P01",
"cfdi_residenciafiscal": "",
"cfdi_numregidtrib": "",
"xml_file": "UABF781203TU7_I_A1.xml",
"xml_path": "frontend/buzonfacturas/1_LAN7008173R5/UABF781203TU7_I_A1.xml",
"xml_downloads": 0,
"pdf_file": "",
"pdf_path": "",
"pdf_downloads": 0,
"active": 1,
"created_at": "2022-03-29 00:22:53",
"updated_at": "2022-03-29 00:49:17"
}
}