Facturación

Crear factura

POST/facturacion/facturas

Crea una factura asociada a una venta, sucursal, emisor, receptor y folio.

Rutas alternativas

/facturacion/notascredito/:tkFacturaDevolver

Parámetros

Nombre	Tipo	Validación	Descripción
`tkFolio`	String	Requerido	Código token del folio.
`tkVenta`	String	Requerido	Código token de la venta.
`tkSucursal`	String	Requerido	Código token de la sucursal.
`tkRazonEmisor`	String	Requerido	Código token del emisor.
`tkRazonReceptor`	String	Requerido	Código token del receptor.
`idMetodoPago`	Integer		Identificador del método de pago SAT.
`idFormaPago`	Integer		Identificador de la forma de pago SAT.
`metodoPago`	String		Método de pago.
`formaPago`	String		Forma de pago.
`condicionesPago`	String		Valor de condicionesPago.
`idUsoCfdi`	Integer		Identificador del uso de CFDI.
`serie`	String		Serie.
`tkFacturaCancelar`	String		Valor de tkFacturaCancelar.
`tkFacturaDevolver`	String		Valor de tkFacturaDevolver.
`folio`	String		Número de folio.
`moneda`	String		Valor de moneda.
`tipoDeCambio`	Float		Tipo de cambio.
`parcialidades`	String		Valor de parcialidades.
`marcarCobrado`	Integer		Valor de marcarCobrado.
`complementos`	Array<Object>		Valor de complementos.
`adjuntar`	Integer		Indica si se adjuntan archivos.
`uuid`	String		UUID fiscal.
`tipoComprobante`	String		Tipo de comprobante.
`folioPreasignado`	String		Valor de folioPreasignado.
`status`	Integer		Estado.
`anticipo`	Integer		Valor de anticipo.
`montoAnticipo`	Float		Valor de montoAnticipo.
`fecha`	Date		Fecha.
`fechaTimbrado`	Date		Fecha de timbrado.

Respuesta

Nombre	Tipo	Descripción
`code`	Integer	Código del resultado.
`msg`	String	Mensaje del resultado.
`details`	String	Datos adicionales.

Solicitud

curl --request POST \
  --url 'https://api.upnify.com/v4/facturacion/facturas' \
  --header 'token: 00000000-0000-4000-8000-000000000001' \
  --header 'content-type: application/json' \
  --data-raw '{"tkFolio":"00000000-0000-4000-8000-000000000001","tkVenta":"00000000-0000-4000-8000-000000000001","tkSucursal":"00000000-0000-4000-8000-000000000001","tkRazonEmisor":"00000000-0000-4000-8000-000000000001","tkRazonReceptor":"00000000-0000-4000-8000-000000000001","idMetodoPago":1,"idFormaPago":1,"metodoPago":"valor-de-ejemplo","formaPago":"valor-de-ejemplo","condicionesPago":"valor-de-ejemplo","idUsoCfdi":1,"serie":"A","tkFacturaCancelar":"00000000-0000-4000-8000-000000000001","tkFacturaDevolver":"00000000-0000-4000-8000-000000000001","folio":"valor-de-ejemplo","moneda":"valor-de-ejemplo","tipoDeCambio":1,"parcialidades":"valor-de-ejemplo","marcarCobrado":1,"complementos":[],"adjuntar":1,"uuid":"00000000-0000-4000-8000-000000000020","tipoComprobante":"valor-de-ejemplo","folioPreasignado":"valor-de-ejemplo","status":1,"anticipo":1,"montoAnticipo":1,"fecha":"2026-01-15","fechaTimbrado":"2026-01-15"}'const response = await fetch("https://api.upnify.com/v4/facturacion/facturas", {\n  method: "POST",\n  headers: { token: "00000000-0000-4000-8000-000000000001", "content-type": "application/json" },\n  body: JSON.stringify({
  "tkFolio": "00000000-0000-4000-8000-000000000001",
  "tkVenta": "00000000-0000-4000-8000-000000000001",
  "tkSucursal": "00000000-0000-4000-8000-000000000001",
  "tkRazonEmisor": "00000000-0000-4000-8000-000000000001",
  "tkRazonReceptor": "00000000-0000-4000-8000-000000000001",
  "idMetodoPago": 1,
  "idFormaPago": 1,
  "metodoPago": "valor-de-ejemplo",
  "formaPago": "valor-de-ejemplo",
  "condicionesPago": "valor-de-ejemplo",
  "idUsoCfdi": 1,
  "serie": "A",
  "tkFacturaCancelar": "00000000-0000-4000-8000-000000000001",
  "tkFacturaDevolver": "00000000-0000-4000-8000-000000000001",
  "folio": "valor-de-ejemplo",
  "moneda": "valor-de-ejemplo",
  "tipoDeCambio": 1,
  "parcialidades": "valor-de-ejemplo",
  "marcarCobrado": 1,
  "complementos": [],
  "adjuntar": 1,
  "uuid": "00000000-0000-4000-8000-000000000020",
  "tipoComprobante": "valor-de-ejemplo",
  "folioPreasignado": "valor-de-ejemplo",
  "status": 1,
  "anticipo": 1,
  "montoAnticipo": 1,
  "fecha": "2026-01-15",
  "fechaTimbrado": "2026-01-15"
}),\n});\n\nconsole.log(await response.json());const response = await fetch("https://api.upnify.com/v4/facturacion/facturas", {\n  method: "POST",\n  headers: { token: "00000000-0000-4000-8000-000000000001", "content-type": "application/json" },\n  body: "{\"tkFolio\":\"00000000-0000-4000-8000-000000000001\",\"tkVenta\":\"00000000-0000-4000-8000-000000000001\",\"tkSucursal\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonEmisor\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonReceptor\":\"00000000-0000-4000-8000-000000000001\",\"idMetodoPago\":1,\"idFormaPago\":1,\"metodoPago\":\"valor-de-ejemplo\",\"formaPago\":\"valor-de-ejemplo\",\"condicionesPago\":\"valor-de-ejemplo\",\"idUsoCfdi\":1,\"serie\":\"A\",\"tkFacturaCancelar\":\"00000000-0000-4000-8000-000000000001\",\"tkFacturaDevolver\":\"00000000-0000-4000-8000-000000000001\",\"folio\":\"valor-de-ejemplo\",\"moneda\":\"valor-de-ejemplo\",\"tipoDeCambio\":1,\"parcialidades\":\"valor-de-ejemplo\",\"marcarCobrado\":1,\"complementos\":[],\"adjuntar\":1,\"uuid\":\"00000000-0000-4000-8000-000000000020\",\"tipoComprobante\":\"valor-de-ejemplo\",\"folioPreasignado\":\"valor-de-ejemplo\",\"status\":1,\"anticipo\":1,\"montoAnticipo\":1,\"fecha\":\"2026-01-15\",\"fechaTimbrado\":\"2026-01-15\"}",\n});\n\nconsole.log(await response.json());import requests\n\nresponse = requests.post(\n    "https://api.upnify.com/v4/facturacion/facturas",\n    json={
  "tkFolio": "00000000-0000-4000-8000-000000000001",
  "tkVenta": "00000000-0000-4000-8000-000000000001",
  "tkSucursal": "00000000-0000-4000-8000-000000000001",
  "tkRazonEmisor": "00000000-0000-4000-8000-000000000001",
  "tkRazonReceptor": "00000000-0000-4000-8000-000000000001",
  "idMetodoPago": 1,
  "idFormaPago": 1,
  "metodoPago": "valor-de-ejemplo",
  "formaPago": "valor-de-ejemplo",
  "condicionesPago": "valor-de-ejemplo",
  "idUsoCfdi": 1,
  "serie": "A",
  "tkFacturaCancelar": "00000000-0000-4000-8000-000000000001",
  "tkFacturaDevolver": "00000000-0000-4000-8000-000000000001",
  "folio": "valor-de-ejemplo",
  "moneda": "valor-de-ejemplo",
  "tipoDeCambio": 1,
  "parcialidades": "valor-de-ejemplo",
  "marcarCobrado": 1,
  "complementos": [],
  "adjuntar": 1,
  "uuid": "00000000-0000-4000-8000-000000000020",
  "tipoComprobante": "valor-de-ejemplo",
  "folioPreasignado": "valor-de-ejemplo",
  "status": 1,
  "anticipo": 1,
  "montoAnticipo": 1,
  "fecha": "2026-01-15",
  "fechaTimbrado": "2026-01-15"
},\n    headers={"token": "00000000-0000-4000-8000-000000000001"},\n)\nresponse.raise_for_status()\nprint(response.json())package main\n\nimport (\n  "fmt"\n  "io"\n  "net/http"\n  "strings"\n)\n\nfunc main() {\n  request, _ := http.NewRequest(http.MethodPost, "https://api.upnify.com/v4/facturacion/facturas", strings.NewReader("{\"tkFolio\":\"00000000-0000-4000-8000-000000000001\",\"tkVenta\":\"00000000-0000-4000-8000-000000000001\",\"tkSucursal\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonEmisor\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonReceptor\":\"00000000-0000-4000-8000-000000000001\",\"idMetodoPago\":1,\"idFormaPago\":1,\"metodoPago\":\"valor-de-ejemplo\",\"formaPago\":\"valor-de-ejemplo\",\"condicionesPago\":\"valor-de-ejemplo\",\"idUsoCfdi\":1,\"serie\":\"A\",\"tkFacturaCancelar\":\"00000000-0000-4000-8000-000000000001\",\"tkFacturaDevolver\":\"00000000-0000-4000-8000-000000000001\",\"folio\":\"valor-de-ejemplo\",\"moneda\":\"valor-de-ejemplo\",\"tipoDeCambio\":1,\"parcialidades\":\"valor-de-ejemplo\",\"marcarCobrado\":1,\"complementos\":[],\"adjuntar\":1,\"uuid\":\"00000000-0000-4000-8000-000000000020\",\"tipoComprobante\":\"valor-de-ejemplo\",\"folioPreasignado\":\"valor-de-ejemplo\",\"status\":1,\"anticipo\":1,\"montoAnticipo\":1,\"fecha\":\"2026-01-15\",\"fechaTimbrado\":\"2026-01-15\"}"))\n  request.Header.Set("token", "00000000-0000-4000-8000-000000000001")\n  request.Header.Set("Content-Type", "application/json")\n  response, _ := http.DefaultClient.Do(request)\n  defer response.Body.Close()\n  body, _ := io.ReadAll(response.Body)\n  fmt.Println(string(body))\n}using System.Net.Http;\nusing System.Text;\n\nusing var client = new HttpClient();\nusing var request = new HttpRequestMessage(HttpMethod.Post, "https://api.upnify.com/v4/facturacion/facturas");\nrequest.Headers.Add("token", "00000000-0000-4000-8000-000000000001");\nrequest.Content = new StringContent("{\"tkFolio\":\"00000000-0000-4000-8000-000000000001\",\"tkVenta\":\"00000000-0000-4000-8000-000000000001\",\"tkSucursal\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonEmisor\":\"00000000-0000-4000-8000-000000000001\",\"tkRazonReceptor\":\"00000000-0000-4000-8000-000000000001\",\"idMetodoPago\":1,\"idFormaPago\":1,\"metodoPago\":\"valor-de-ejemplo\",\"formaPago\":\"valor-de-ejemplo\",\"condicionesPago\":\"valor-de-ejemplo\",\"idUsoCfdi\":1,\"serie\":\"A\",\"tkFacturaCancelar\":\"00000000-0000-4000-8000-000000000001\",\"tkFacturaDevolver\":\"00000000-0000-4000-8000-000000000001\",\"folio\":\"valor-de-ejemplo\",\"moneda\":\"valor-de-ejemplo\",\"tipoDeCambio\":1,\"parcialidades\":\"valor-de-ejemplo\",\"marcarCobrado\":1,\"complementos\":[],\"adjuntar\":1,\"uuid\":\"00000000-0000-4000-8000-000000000020\",\"tipoComprobante\":\"valor-de-ejemplo\",\"folioPreasignado\":\"valor-de-ejemplo\",\"status\":1,\"anticipo\":1,\"montoAnticipo\":1,\"fecha\":\"2026-01-15\",\"fechaTimbrado\":\"2026-01-15\"}", Encoding.UTF8, "application/json");\nusing var response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());

Respuesta

[
  {
    "code": 0,
    "msg": "Ok",
    "details": "[{\"tk\":\"00000000-0000-4000-8000-000000000010\"}]"
  }
]

Crear factura

Rutas alternativas

Parámetros

Respuesta

Solicitud

Solicitud

Respuesta

Respuesta exitosa