[POST] - Crear factura o borrador

Para crear una nueva Factura o Borrador debe proporcionar en los encabezados API-ID, API-Key y llena el JSON especificado más abajo.

Una Factura se distingue de un Borrador por el hecho de ser timbrada y validad ante el SAT mientras que un Borrador es un bosquejo de lo que se tiene pensado realizar como factura, no esta timbrada ni validad y en el futuro usted podra actualizar sus Borradores para posteriormente timbrarlas y se conviertan en Facturas.

Header Parameters
`API-ID` string — REQUIRED Generada por Stampi
`API-Key` string — REQUIRED Generada por Stampi

Request Body

type string

Possible values: [CREATE_INVOICE]

Indica la creación de la factura

data object

autoStamp boolean

Possible values: [true, false]

true si la factura debe ser timbrada y validada ante el SAT.

false si debe crearse un nuevo borrador.

fechaExpedicion date-time

Fecha de creación de la factura.

lugarExpedicion zip-code

Código postal del emisor, el codigo debe ser el mismo con el que se registro ante el SAT.

paymentMethod string

Possible values: [PUE, PDD]

Indica la forma de pago de la factura.

PUE: Pago Una Exihibición 

PDD: Pago Parcialidad o Diferido

paymentType string

Possible values: [01, 02]

PUE: 01 

PDD: 02

regimenFiscal string

Régimen fiscal en el que esta registrado el?? PREGUNTAR

useCFDi string

Uso CFDI

preciosConImpuesto boolean

Precios con impuesto

currency iso-4717

Possible values: [MXN]

Moneda

exchangeRate number

Tipo de cambio

invoiceType string

Possible values: [E, I, N, P, T]

Tipo de factura:

E: Egreso 

I: Ingreso 

N: Nómina 

E: Egreso

clientPostalCode zip-code

Código postal del receptor, el codigo debe ser el mismo con el que se registro ante el SAT.

serie string

Campo de uso interno

folio string

Campo de uso interno

issuerRFC string

RFC (Registro Federal de Contribuyentes) Emisor

receiverRFC string

RFC (Registro Federal de Contribuyentes) Receptor

attachments object[]

Puedes enlazar url's de archivos

type string

Possible values: [url]

label string

Nombre del archivo

value string

Possible values: [https://www.google.com]

Enlaze del archivo

conceptos object

concepto object[]

descripcion string

Possible values: [MyFirstProducts]

descripcionClaveProdServ string

Possible values: [Agua (50202301)]

Este campo se conforma de las descripciones y códigos de los productos y servicios registrados en el catálogo de productos y servicios del SAT

claveProdServ string

Possible values: [50202301]

Este campo se conforma del código de los productos y servicios registrados en el catálogo de productos y servicios del SAT

descripcionClaveUnidad string

Possible values: [Pieza (Pza) (H87)]

Este campo hace referencia a la descripción completa de la unidad en el que se mide el producto o servicio. La descripción completa se extraen del catálogo de unidades del SAT

symbol string

Possible values: [Pza]

Este campo hace referencia al símbolo de la unidad en el que se mide el producto o servicio. Los simbolos se extraen del catálogo de unidades del SAT

unidad string

Possible values: [Pieza]

Este campo hace referencia a la unidad en el que se mide el producto o servicio. La unidad se extrae del catálogo de unidades del SAT

claveUnidad string

Possible values: [H87]

Este campo hace referencia a la clave de la unidad en el que se mide el producto o servicio. La clave de la unidad se extrae del catálogo de unidades del SAT

cantidad number

Possible values: [1]

Cantidad del producto o servicio, para la creación recomendamos usar 1

valorUnitario number

Possible values: [1]

Valor por unidad del producto o servicio

importe number

Hace referencia al valor resultante entre la cantidad multiplicado por el valor unitario

importeImpuesto number

Hace referencia al valor resultante entre el importe - descuento + impuestos, se recomienda utilizar IVA trasladado (0%, 8%, 16%) en este punto.

descuento number

Se refiere al descuento en dinero que es aplicable al producto o servicio, en caso de que no aplique se recominda mandar 0

porcDescuento number

Se refiere al descuento en procentaje que es aplicable al producto o servicio, en caso de que no aplique se recominda mandar 0

tipoDescuento string

Possible values: [%, $]

Se refiere al tipo descuento en procentaje que es aplicable al producto o servicio

objetoImpCode string

Se refiere al tipo descuento que se aplica al producto o servicio

objetoImpDescription string

impuestos

Se refiere a los impuestos que se aplican al producto o servicio como IVA, ISR o IEPS.

Se recomienda por API aplicar solamente IVA y utilizar la siguiente estructura:

  {"traslados":

      {"traslado":[

        {

            "key":"87dc1a03-ff53-4eec-b543-4602b37dd039",

            "tasaOcuota":"",

            "valorTasaOcuota":0.16,

            "valorTasaOcuotaPorc":16,

            "impuesto":"002",

            "nombreImpuesto":

            "IVA",

            "tipoImpuesto":

            "traslado",

            "rangoFijo":"Fijo",

            "tipoFactor":"Tasa"

        }

    ]

    },

    "retenciones":{"retencion":[]}}

traslados object

traslado object[]

key string

Identificador del impuesto

importe string

Valor del impuesto calculado

impuesto string

Possible values: [001, 002, 003]

Tipo de impuesto:

ISR 

IVA 

IEPS

nombreImpuesto string

Possible values: [ISR, IVA, IEPS]

Nombre del impuesto:

ISR 

IVA 

IEPS

rangoFijo string

Possible values: [Fijo, Rango]

Indica si es fijo o variable

tipoFactor string

Possible values: [Tasa, Cuota]

Indica si es tipo de factor es Tasa o Cuota

tipoImpuesto string

Possible values: [traslado, retencion]

Indica el tipo de impuesto, si es trasladado o retenido

valorTasaOcuota number

Valor del impuesto calculado

valorTasaOcuotaPorc number

Possible values: [0.16]

Porcentaje del impuesto

retenciones object

retencion object[]

key string

Identificador del impuesto

importe string

Valor del impuesto calculado

impuesto string

Possible values: [001, 002, 003]

Tipo de impuesto:

ISR 

IVA 

IEPS

nombreImpuesto string

Possible values: [ISR, IVA, IEPS]

Nombre del impuesto:

ISR 

IVA 

IEPS

rangoFijo string

Possible values: [Fijo, Rango]

Indica si es fijo o variable

tipoFactor string

Possible values: [Tasa, Cuota]

Indica si es tipo de factor es Tasa o Cuota

tipoImpuesto string

Possible values: [traslado, retencion]

Indica el tipo de impuesto, si es trasladado o retenido

valorTasaOcuota number

Valor del impuesto calculado

valorTasaOcuotaPorc number

Possible values: [0.16]

Porcentaje del impuesto

sku string

codigoBarras string

tipo string

Possible values: [product, service]

Se refiere al tipo: producto o servicio

impuestos object

impuesto undefined[]

traslados object

Traslado (circular)[]

retenciones object

Retencion (circular)[]

totalImpuestosRetenido number

Suma total de los importes de impuesto retenidos

totalImpuestosTrasladados number

Suma total de los importes de impuesto trasladados

Responses

201

Success Response

Schema

object

{
"id": "55ddc7b2-59f0-11ed-bcff-5aee9affd8f2",
"message": "invoice ha sido creado",
"data": {
"id": "55ddc7b2-59f0-11ed-bcff-5aee9affd8f2",
"createdAt": "2022-11-01T08:20:28.597443-06:00",
"updatedAt": "2022-11-01T08:20:28.597443-06:00",
"stampingDate": "2022-11-01T08:20:28.597443-06:00",
"companyId": "25ecbe52-251f-11ec-a102-1e00621e1b72",
"folio": "79",
"serie": "A",
"fechaExpedicion": "2022-01-12T17:01:13.738-06:00",
"lugarExpedicion": "89512",
"metodoPagoID": "bfc3fb52-4f0a-4c75-919d-c927e3309fbe",
"formaPagoID": "e9b7026f-0ec1-4eff-875c-1970447ea250",
"regimenFiscalID": "faf45115-2546-4c3c-aebd-8e6c3e5156d2",
"usoCfdiID": "630f20eb-c458-46a4-ac08-869cfc37665c",
"preciosConImpuesto": false,
"currencyID": "2dc20205-b5c4-4791-846b-d3fae1fd764f",
"exchangeRate": 1,
"invoiceTypeID": "4da7160a-76b2-4c95-8334-471cb5c72aa8",
"receiverId": "9edf3260-3850-11ec-a0c7-1e00621e1b72",
"issuerId": "6ea1fcca-52b6-11ec-a259-0e1e337f2d43",
"metadata": {},
"missing": null,
"attachments": [
  {
    "type": "url",
    "label": "string",
    "value": "https://www.google.com"
  }
],
"conceptos": {
  "concepto": [
    {
      "key": "988a6022-ddb6-478d-bbb3-6dfb87260cb6",
      "descripcion": "MyFirstProducts",
      "cantidad": 1,
      "claveProdServ": "50202301",
      "descripcionClaveProdServ": "Agua (50202301)",
      "unidad": "Pieza",
      "claveUnidad": "H87",
      "descripcionClaveUnidad": "Pieza (Pza) (H87)",
      "valorUnitario": 1,
      "descuento": 0,
      "porcDescuento": 0,
      "tipoDescuento": "%",
      "symbol": "Pza",
      "impuestos": {
        "traslados": {
          "traslado": [
            {
              "key": "559d899d-3481-4bea-8a92-fcafdd606741",
              "importe": "16.5",
              "valorTasaOcuota": 16,
              "valorTasaOcuotaPorc": 1600,
              "impuesto": "002",
              "nombreImpuesto": "IVA",
              "tipoImpuesto": "traslado",
              "rangoFijo": "Fijo",
              "tipoFactor": "Tasa"
            }
          ]
        },
        "retenciones": {}
      },
      "objetoImpCode": "02",
      "objetoImpDescription": "Si objeto de impuesto"
    }
  ]
},
"impuestos": {
  "impuesto": [
    {
      "totalImpuestosTrasladados": 16,
      "retenciones": {},
      "traslados": {
        "Traslado": [
          {
            "Base": 100,
            "Importe": 16,
            "Impuesto": "002",
            "TasaOCuota": "0.16",
            "TipoFactor": "Tasa"
          }
        ]
      }
    }
  ]
},
"complemento": {
  "version": "1.0"
},
"status": {
  "draft": true
},
"autoStamp": false,
"exportacionCode": "01",
"exportacionDescription": "No aplica",
"pagada": false,
"canceladaSAT": false,
"company": {
  "id": "25ecbe52-251f-11ec-a102-1e00621e1b72",
  "createdAt": "2021-10-04T09:27:05.212884-05:00",
  "updatedAt": "2022-05-24T09:45:22.226746-05:00",
  "ownerId": "25682822-251f-11ec-a102-1e00621e1b72",
  "name": "Personal Edder",
  "usersId": null,
  "cfdiVersion": "4.0",
  "pagoVersion": "2.0",
  "cancelacionVersion": "4.0",
  "users": null
},
"receiver": {
  "id": "9edf3260-3850-11ec-a0c7-1e00621e1b72",
  "createdAt": "2021-10-28T19:39:05.560943-05:00",
  "updatedAt": "2022-07-14T16:57:58.839809-05:00",
  "clientCode": "0",
  "tradeName": "INGRID XODAR JIMENEZ",
  "businessName": "INGRID XODAR JIMENEZ",
  "companyId": "25ecbe52-251f-11ec-a102-1e00621e1b72",
  "taxId": "XOJI740919U48",
  "postalCode": "88965",
  "contacts": [
    {
      "fullName": "Edder",
      "officePhone": {
        "phone": "8331720069",
        "code": 52,
        "short": "MX"
      },
      "cellPhone": {},
      "email": "arskang@gmail.com",
      "socialNetworks": {}
    }
  ],
  "useCfdiId": "5a1e91d4-a771-4533-ac05-91bef92cf06f",
  "taxRegimeId": "5486c098-e82a-4a16-9f16-2067946fbb6c",
  "outsider": false
},
"issuer": {
  "id": "6ea1fcca-52b6-11ec-a259-0e1e337f2d43",
  "createdAt": "2021-12-01T08:53:23.527814-06:00",
  "updatedAt": "2022-11-01T08:20:28.300351-06:00",
  "tradeName": "XOCHILT CASAS CHAVEZ",
  "businessName": "XOCHILT CASAS CHAVEZ",
  "companyId": "25ecbe52-251f-11ec-a102-1e00621e1b72",
  "taxId": "CACX7605101P8",
  "postalCode": "10740",
  "keyFile": "",
  "certFile": "",
  "password": "12345678a",
  "taxRegimeId": "faf45115-2546-4c3c-aebd-8e6c3e5156d2",
  "lastFolio": "79",
  "blockBatchWebhook": true,
  "automaticFolio": true,
  "lastFolioPago": "84",
  "automaticFolioPago": true,
  "series": [
    "A"
  ],
  "cfdiVersion": "4.0",
  "pagoVersion": "2.0",
  "cancelacionVersion": "4.0"
},
"stamp": {
  "qrString": null,
  "cadenaOriginal": null,
  "noCertificado": null,
  "fechaTimbrado": null,
  "selloCFD": null,
  "noCertificadoSAT": null,
  "selloSAT": null,
  "version": null,
  "uuid": null,
  "xml": null,
  "acuseCancelacionXML": null
},
"pago": {
  "metadata": null,
  "xml": null,
  "canceladaSAT": false,
  "omitFilter": false,
  "acuseCancelacionXML": null
}
}}