Productos

Los productos definen partidas reutilizables con códigos del catálogo del SAT y configuración de impuestos predeterminada.

Crear un producto

curl https://api.facturacion.srs-ngr.com/v1/productos \
  -u sk_test_xxx: \
  -H "Content-Type: application/json" \
  -d '{
    "organizacion": "org_1a2b3c4d",
    "descripcion": "Servicio de consultoría en TI",
    "valor_unitario": "1000.000000",
    "clave_prod_serv": "80101500",
    "clave_unidad": "E48",
    "unidad": "Servicio",
    "no_identificacion": "CONSUL-001",
    "objeto_imp": "02",
    "impuestos_default": {
      "traslados": [
        {"impuesto": "002", "tipo_factor": "Tasa", "tasa_o_cuota": "0.160000"}
      ]
    }
  }'

Campos requeridos

Campo	Descripción	Ejemplo
`descripcion`	Descripción del producto	`"Servicio de consultoría"`
`valor_unitario`	Precio unitario (6 decimales)	`"1000.000000"`
`clave_prod_serv`	Código de producto/servicio del SAT	`"80101500"`
`clave_unidad`	Código de unidad del SAT	`"E48"`
`objeto_imp`	Objeto de impuesto: `"01"` (no), `"02"` (sí), `"03"` (sí, exento)	`"02"`

Impuestos predeterminados

Cuando objeto_imp es "02", defina los impuestos predeterminados que aplican a este producto:

{
  "impuestos_default": {
    "traslados": [
      {"impuesto": "002", "tipo_factor": "Tasa", "tasa_o_cuota": "0.160000"}
    ],
    "retenciones": [
      {"impuesto": "001", "tipo_factor": "Tasa", "tasa_o_cuota": "0.100000"}
    ]
  }
}

Códigos de impuesto comunes:

`impuesto`	Nombre	Tasas comunes
`001`	ISR	Retención: 0.100000
`002`	IVA	Traslado: 0.160000, 0.080000, 0.000000
`003`	IEPS	Variable

Al crear una factura con una referencia a producto, estos impuestos se aplican automáticamente.

Buscar productos

curl "https://api.facturacion.srs-ngr.com/v1/productos?organizacion=org_1a2b3c4d&q=consultoría" \
  -u sk_test_xxx:

Busca en descripcion y no_identificacion (SKU).

Búsqueda en catálogos del SAT

Encuentre la clave_prod_serv correcta (más de 55,000 códigos):

curl "https://api.facturacion.srs-ngr.com/v1/catalogos/claves_prod_serv?q=software&limite=10" \
  -u sk_test_xxx:

Encuentre códigos de unidad:

curl "https://api.facturacion.srs-ngr.com/v1/catalogos/claves_unidad?q=pieza" \
  -u sk_test_xxx:

Clientes Pagos