Productos

No hay /v1/products: los productos se guardan en el panel, en Productos y servicios. Lo que sí hace la API es usarlos, y una factura puede llevar partidas guardadas y partidas escritas a mano en la misma llamada.

Para qué sirve guardar uno: las dos claves del SAT son la parte que nadie quiere volver a teclear, y equivocarse en una es un rechazo. Con product_id la partida hereda lo que no diga.

Los campos de una partida

description: requerido; Lo que se vendió, en palabras. Es lo que lee tu cliente.
quantity: requerido; Cuántas unidades. Admite hasta seis decimales.
unit_price: requerido; Como texto con dos decimales. Un float perdería centavos.
product_service_key: requerido*; La clave del catálogo c_ClaveProdServ. La rellena el producto si mandas product_id.
unit_key: requerido*; La clave del catálogo c_ClaveUnidad. Igual que la anterior.
discount: opcional; El descuento de esa partida. No puede ser mayor que su importe.
tax_object: opcional; Del catálogo c_ObjetoImp. 02 si no lo dices, que es la partida ordinaria.
vat_rate: opcional; La tasa de esa partida: 0.16, 0.08 o 0. Una factura puede mezclarlas.
product_id: opcional; Un producto guardado, que rellena lo que la partida no diga.

Los marcados con asterisco son obligatorios sólo si la partida no nombra un producto que ya los tenga.

La tasa es de la partida

Una misma factura puede llevar honorarios al 16% y medicinas al 0%, y el comprobante agrupa los traslados por tasa. La vat_rate del comprobante, si la mandas, es sólo el default de las partidas que no digan la suya.

tax_object es otra pregunta, no la misma: una partida al 0% sí es objeto de impuesto y se desglosa, mientras que una 01 no lleva nodo de impuestos en absoluto. No son intercambiables, porque cambian lo que tu cliente puede acreditar.