[POST] - Crear un concepto

Para crear un nuevo concepto debe proporcionar el los encabezados su API-ID y API-Key y llenar correctamente el JSON requiere el concepto. Más abajo se muestra el cuerpo del concepto.

Header Parameters
`API-ID` string — REQUIRED Generada por Stampi
`API-Key` string — REQUIRED Generada por Stampi
`Key` uuid — REQUIRED Identificador único del concepto, este parámetro es de uso interno

Request Body — REQUIRED

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

Responses

200

Success Response

Schema

object

{
"status": 200,
"error": null,
"data": {
  "id": "6acedf34-4993-4d89-9488-cd167acacbfc",
  "createdAt": "2022-10-31T12:15:39.784941-06:00",
  "updatedAt": "2022-10-31T12:15:39.784941-06:00",
  "descripcion": "MyFirstProducts2",
  "claveProdServ": "50202301",
  "descripcionClaveProdServ": "Agua (50202301)",
  "unidad": "Pieza",
  "claveUnidad": "H87",
  "descripcionClaveUnidad": "Pieza (Pza) (H87)",
  "valorUnitario": 1,
  "importe": 0,
  "cantidad": 1,
  "importeImpuesto": 0,
  "symbol": "Pza",
  "descuento": 0,
  "porcDescuento": 0,
  "tipoDescuento": "%",
  "compañia": {
    "ownerId": null,
    "name": "",
    "usersId": null,
    "cfdiVersion": null,
    "pagoVersion": null,
    "cancelacionVersion": null,
    "users": null
  },
  "impuestos": {
    "traslados": {
      "traslado": [
        {
          "key": "87dc1a03-ff53-4eec-b543-4602b37dd039",
          "importe": "16.5",
          "valorTasaOcuota": 16,
          "valorTasaOcuotaPorc": 0.16,
          "impuesto": "002",
          "nombreImpuesto": "IVA",
          "tipoImpuesto": "traslado",
          "rangoFijo": "Fijo",
          "tipoFactor": "Tasa"
        }
      ]
    },
    "retenciones": {}
  },
  "objetoImpCode": "string",
  "objetoImpDescription": "string",
  "sku": "string",
  "codigoBarras": "string",
  "tipo": "product"

}

}