Editar Factura

Dentro de el manejo de este endpoint es importante tener en cuenta que hay varios campos que no será posible poder modificarlos como por ejemplo el document.id, customer.rfc_id y si dentro de la configuración del documento está como numeración manual el campo de number, de igual forma para aquellas facturas que estén en proceso de envío aL SAT o timbradas. Para facturas timbradas se debe realizar mediante una nota crédito electrónica.

Nombre	Tipo	Descripción	Características
document.id	number	Identificador del tipo de comprobante.	Campo obligatorio, debe existir en Siigo previamnete, se puede consultar por: /document-types
number	number	Consecutivo/número del comprobante	El campo opcional u obligatorio dependiendiendo la configuración de Siigo Nube, si se envia debe ser el mismo consecutivo de la factura.
customer.rfc_id	string	Número de RFC del cliente.	Campo obligatorio, no se puede modificar, debe estar activo.
customer.branch_office	number	Número de Sucursal del cliente.	Campo opcional, si no se envia toma por defecto el 0.
seller	number	Identificador del vendedor asociado a la factura.	Campo obligatorio, debe existir en Siigo Nube, se puede consultar por la ruta: /users
observations	string	Comentarios u observaciones de la factura.	Campo opcional, tiene un limite de 4.000 carácteres.
use	string	Código de uso CFDi.	Campo obligatorio, consulte el listado de códigos válidos por el SAT para cada tipo de persona aquí.
cost_center	number	Identificador del Centro de costos.	Campo opcional, debe existir en Siigo Nube y estar activo.
retentions	array	Array con los id de los impuestos tipo ReteIVA y/o Rete ISR.	Campo opcional, se puede consultar por la ruta: /taxes
items.code	string	Código único del producto o servicio.	Campo obligatorio, debe existir en Siigo Nube y estar activo, alfanúmerico.
items.description	string	Nombre o descripción del producto/servicio.	Campo opcional, si no maneja descripción larga en la configuración y se envia toma el nombre del producto. Si maneja descripción larga en la configuración del producto y no se envia debe tomar la descipción de la configuración del producto. Si se envia y viene vacio lo tomara así en la factura.
items.quantity	number	Cantidad. En Siigo Nube queda registado con dos decimales.	Campo obligatorio, númerico de máximo 2 decimales.
items.price	number	Precio del producto / Valor unitario.	Campo obligatorio, númerico de máximo 2 decimales.
items.discount	number	Valor de descuento del producto.	Campo opcional, puede ser por valor o porcentaje dependiendo de la configuración de la factura.
items.warehouse	number	Identificador de la bodega/almacén asociada al producto.	Campo opcional, si se envia debe existir en Siigo nube y estar activo.
payment.method	string	Método de pago si fue en una exhibición seria PUE y PPD si es diferido.	Campo obligatorio, solo puede ir con los valores: PUE o PPD, no se puede modificar.
payment.cfdi	string	Código de la forma de pago CFDI.	Campo obligatorio, consulte el listado de códigos válidos por el SAT para cada método aquí.
payment.paid	boolean	Indica si la factura fue pagada o no.	Campo obligatorio, si es PPD por defecto toma paid = False y si es PUE debe identificar si fue paga debe ser "true" o si maneja vencimiento debe ir "false".
payment.conditions.id	number	ID de la condición de pago.	Campo obligatorio, debe existir en Siigo Nube y etsar activa, se puede consultar por la ruta: /payment-types
payment.conditions.value	number	Valor asociado a la condición de pago.	Campo obligatorio, númerico, máximo 2 decimales.
payment.conditions.due_date	string	Fecha pago del vencimiento de la factura.	Campo obligatorio, formato de fecha.

Authorization

application/json<token>

In: header

Authorization<token>

[access_token]

In: header

SiigoAPI-Application-Id<token>

nombre de la aplicación que estás integrando

In: header

Request Body

application/jsonOptional

Representa la solicitud con la información actualizada de la factura.

document

Required

object

Información del documento de la factura.

numberinteger

Consecutivo/número del comprobante

customer

Required

object

Información del cliente de la factura.

seller

Required

integer

Identificador del vendedor asociado a la factura.

observationsstring

Comentarios u observaciones de la factura.

use

Required

string

Código de uso CFDi.

cost_centerinteger

Identificador del Centro de costos.

items

Required

array<object>

Lista de productos o servicios de la factura.

retentionsarray<integer>

Array con los id de los impuestos tipo ReteIVA y/o Rete ISR.

payment

Required

object

Información de pago para actualización de factura.

curl -X PUT "https://api.siigo.mx/v1/invoices" \
  -H "application/json: <token>" \
  -H "Authorization: <token>" \
  -H "SiigoAPI-Application-Id: <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "document": {
      "id": 24446
    },
    "number": 22,
    "customer": {
      "rfc_id": "MELM8305281H0",
      "branch_office": 0
    },
    "seller": 629,
    "observations": "Observaciones",
    "use": "G01",
    "cost_center": 235,
    "items": [
      {
        "code": "Item-1",
        "description": "Camiseta de algodón",
        "quantity": 2,
        "price": 1069.77,
        "discount": 130,
        "warehouse": 1
      }
    ],
    "retentions": [
      1,
      2
    ],
    "payment": {
      "method": "PUE",
      "cfdi": "01",
      "paid": true,
      "conditions": {
        "id": 5636,
        "value": 1273.03,
        "due_date": "2024-12-31"
      }
    }
  }'

Factura actualizada exitosamente

{
  "id": "63f918c2-ca65-4edc-a7db-66bcdd5159fb",
  "document": {
    "id": 24446
  },
  "number": 22,
  "name": "FV-2-22",
  "date": "2015-12-15",
  "customer": {
    "id": "6b6ceb28-b2eb-4b98-b3dd-26648a933c81",
    "rfc_id": "MELM8305281H0",
    "branch_office": 0
  },
  "cost_center": 235,
  "total": 2546.05,
  "balance": 0,
  "seller": 629,
  "use": {
    "code": "G01",
    "name": "Adquisición de mercancías"
  },
  "observations": "Observaciones",
  "items": [
    {
      "id": "63f918c2-ca65-4edc-a7db-66bcdd5159ps",
      "code": "Item-1",
      "description": "Camiseta de algodón",
      "quantity": 2,
      "price": 1069.77,
      "discount": {
        "percentage": 13,
        "value": 130
      },
      "taxes": [
        {
          "id": 13156,
          "name": "IVA 19%",
          "type": "IVA",
          "percentage": 19,
          "value": 406.51
        }
      ],
      "total": 2546.05
    }
  ],
  "payment": {
    "method": "PUE",
    "conditions": [
      {
        "id": 5636,
        "name": "Efectivo",
        "value": 1273.03
      }
    ]
  },
  "metadata": {
    "created": "2020-06-15T03:33:17.208Z",
    "last_updated": "null"
  }
}

Editar Factura

Authorization

Request Body

Response

TypeScript