Crear Factura de Egreso

Crea un comprobante fiscal de Egreso (Nota de crédito).

Definición

POST https://api.avanto.mx/v1/sales

Argumentos

Argumento	Tipo	Default	Descripción
company_subsidiary_id *	integer	0	Sucursal de empresa emisora
type *	tinyint	3	Tipo de comprobante: 3. Nota de crédito
accounting_effect *	string	"E"	Efecto contable: E. Egreso
emitted	datetime	datetime()	Fecha y hora de emisión; se expresa en el formato AAAA-MM-DDThh:mm:ss
subsidiary_id *	integer	0	ID de la sucursal del cliente (receptor)
carrier	string	""	Transportista: FedEx, UPS, DHL (requiere catálogo)
shipping	string	""	Dato de envío
currency_code	string	"MXN"	Código de la moneda
exchange_rate	decimal	0.0000	Tipo de cambio
payment_options	string	"99"	Forma de pago: 99. Por definir, 01. Efectivo, 02. Cheque nominativo, etc.
payment_method	string	"PUE"	Metodo de pago: PUE. Pago en una sola exhibición, PPD. Pago en parcialidades o diferido
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_regimenfiscal *	string	""	Régimen Fiscal del emisor (Emisor.RegimenFiscal)
cfdi_usocfdi *	string	""	Uso del CFDI (Receptor.UsoCFDI)
soldItems *	Object	-	Productos del comprobante
soldItems.quantity *	decimal	0.0000	Cantidad
soldItems.unit_of_measure	string	""	Unidad de medida del producto (interna)
soldItems.code	string	""	Código o clave del producto (interna)
soldItems.description *	string	""	Descripción del producto
soldItems.unit_price *	decimal	0.0000	Precio unitario
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".
• Si los campos SoldItems.cfdi_claveprodserv y SoldItems.cfdi_claveunidad vienen vacíos en el post, por defecto toman el valor de "01010101" y "H87".
• Si no se especifica el objeto SoldItems.taxes, se supone un Traslado del 16% de IVA directo al importe de base.

Atención

Se requiere al menos dar de alta un producto para poder generar el comprobante correctamente.

Ejemplo

{
    "accounting_effect": "E",
    "currency_id": 2,
    "subsidiary_id": 48,
    "cfdi_regimenfiscal": "601",
    "company_subsidiary_id":1,
    "soldItems": [{
        "quantity": 2,
        "description": "Un producto de los que vendemos",
        "unit_price": 100,
        "discount": 20
    }],
    "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:

POST https://api.avanto.mx/v1/sales/106?company_subsidiary_id=1&expand=cfdidetails,soldItems,salesTaxes

Ejemplo sin precargar Cliente

{
    "accounting_effect": "E",
    "currency_id": 2,
    "cfdi_regimenfiscal": "601",
    "sic_code": "SUL010720JN8",
    "cfdi_usocfdi": "P01",
    "company_subsidiary_id":1,
    "soldItems": [{
        "quantity": 2,
        "description": "Un producto de los que vendemos",
        "unit_price": 100,
        "discount": 20
    }],
    "cfdiRelated": [{
        "uuid": "F7F84A31-3F53-4776-AF38-137E28B7CFB5"
    }]
}

RESPUESTA JSON

Si la transacción se ejecuta correctamente, debe regresar el objeto creado como se muestra en el siguiente JSON:

{
    "id": 49,
    "company_subsidiary_id": 1,
    "accounting_effect": "E",
    "serial_number": "A",
    "folio": 1,
    "emitted": "2019-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": "2019-03-29",
    "days_to_pay": 0,
    "receivable": 1,
    "date_of_payment": "2019-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": "2019-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": "2019-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": "2019-03-29",
    "days_to_pay": 0,
    "receivable": 1,
    "date_of_payment": "2019-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": "2019-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": "2019-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": "2019-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": "2019-03-29 00:49:17",
      "cfdi_nocertificadosat": "20001000000300022323",
      "cfdi_uuid": "2B9A36A6-D08D-45DB-B3DF-A43F485CD48F",
      "cfdi_cadena_original": "||3.3|A|1|2019-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": "2019-03-29 00:22:53",
      "updated_at": "2019-03-29 00:49:17"
    }
}