---
title: "Consultar inventario por código"
method: GET
path: "/api/v1/inventarios/consultaCodigo/{codigo}"
tags: ["Inventario"]
---

# Consultar inventario por código

`GET /api/v1/inventarios/consultaCodigo/{codigo}`

<div id='DatosCrear'><p>Consultar inventario por c&oacute;digo</p><div id='get'><span></span>https://api.worldoffice.cloud/api/v1/inventarios/consultaCodigo/{codigo}</div>Consulta la información del inventario registrado en el sistema, con base en el codigó recibidoRespuesta en el contenido de la petici&oacute;n:<pre>content: [<br>  {<br>    id: integer,<br>    codigo: String,<br>    codigoInternacional: String,<br>    descripcion: String,<br>    unidadMedida: {<br>      id: integer,<br>      nombre: String,<br>      codigo: String,<br>      senDeSistema: boolean,<br>      unidadMedidaTipo: {<br>        id: integer,<br>        nombre: String<br>      },<br>      unidadMedidaAdministradorImpuestos: {<br>        id: integer,<br>        codigo: String,<br>        descripcion: String,<br>        ubicacionPais: {<br>          id: integer,<br>          nombre: String,<br>          String codigo: String,<br>          String cod_alterno: String<br>        }<br>      },<br>      unidadMedidaBaseId: integer,<br>      factor: number<br>    },<br>    senActivo: boolean,<br>    inventarioClasificacion: {<br>      id: integer,<br>      nombre: String,<br>      senAfectaCostoPromedio: boolean,<br>      senDeSistema: boolean<br>    },<br>    centroCosto: {<br>      id: integer,<br>      nombre: String,<br>      codigo: String<br>    },<br>    grupo: {<br>      id: integer,<br>      codigo: String,<br>      nombreGrupo: String,<br>      folder: boolean,<br>      seleccionado: boolean,<br>      senActivo: boolean,<br>      borrador: boolean<br>    },<br>    contabilizacion: {<br>      id: integer,<br>      nombre: String,<br>      codigo: String,<br>      senDeSistema: boolean<br>    },<br>    senFacturarSinExistencias: boolean,<br>    senManejaSeriales: boolean,<br>    utilidadEstimada: number,<br>    impuestos: [<br>      {<br>        id: integer,<br>        valor: number,<br>        senSumaAlCosto: boolean,<br>        idProceso: integer,<br>        impuesto: {<br>          id: integer,<br>          tipo: String,<br>          nombre: String,<br>          tipoCobro: String,<br>          tarifa: number,<br>          empresas: [integer]<br>        },<br>        empresas: [<br>          {<br>            id: integer,<br>            nombre: String,<br>            prefijo: String,<br>            identificacion: String,<br>            digitoVerificacion: integer,<br>            digitoVerificacionGenerado: boolean,<br>            senPrincipal: boolean,<br>            numeroEstablecimientos: integer,<br>            tercero: {<br>              id: integer,<br>              terceroTipoIdentificacion {<br>                id: integer,<br>                abreviatura: String,<br>                nombre: String,<br>                codigo: String,<br>                senEsEmpresa: boolean,<br>                senManejaDV: boolean,<br>                ubicacionPais: {<br>                  id: integer,<br>                  nombre: String,<br>                  codigo: String,<br>                  cod_alterno: String<br>                }<br>              },<br>              identificacion: String,<br>              digitoVerificacion: integer,<br>              digitoVerificacionGenerado: boolean,<br>              primerNombre: String,<br>              segundoNombre: String,<br>              primerApellido: String,<br>              segundoApellido: String,<br>              nombreCompleto: String,<br>              ciudad: {<br>                id: integer,<br>                nombre: String,<br>                codigo: String,<br>                senSistema: boolean<br>                ubicacionDepartamento {<br>                  id: integer,<br>                  nombre: String,<br>                  codigo: String,<br>                  boolean senSistema: boolean<br>                  ubicacionPais: {<br>                    id: integer,<br>                    nombre: String,<br>                    codigo: String,<br>                    cod_alterno: String<br>                  }<br>                },<br>              }<br>              codigo: String,<br>              senActivo: boolean,<br>              senManejaNomina: boolean,<br>              atributos: boolean,<br>              tarifaICA: numeric,<br>              aplicaICAVentas: boolean,<br>              terceroTipos: [<br>                {<br>                  id: integer,<br>                  codigo: String,<br>                  nombre: String<br>                }<br>              ]<br>            },<br>            ubicacionCiudad: {<br>              id: integer,<br>            	 nombre: String,<br>            	 codigo: String,<br>            	 senSistema: String<br>            	 ubicacionDepartamento: {<br>                id: integer,<br>                nombre: String,<br>                codigo: String,<br>                senSistema: boolean,<br>                ubicacionPais: {<br>                  id: integer,<br>                  nombre: String,<br>                  codigo: String,<br>            	     cod_alterno: String<br>                }<br>              }<br>            },<br>            infoTributariaAdicional: String,<br>            responsabilidadFiscal: [<br>              {<br>                id: integer,<br>                codigo: String,<br>                significado: String<br>              }<br>            ]<br>          }<br>        ],<br>        inventarioTipoImpuestoVenta: {<br>          id: integer,<br>          nombre: String,<br>          tipo: String,<br>          ubicacionPais: {<br>            id: integer,<br>            nombre: String,<br>            codigo: String,<br>            cod_alterno: String<br>          }<br>        },<br>        muestraAlerta: boolean<br>      }<br>    ],<br>    atributos: boolean,<br>    senManejaLotes: boolean<br>  }<br>]</pre></div>

## Path parameters

- `codigo` string, required

## Response `202`

La consulta es realizada correctamente

- ResponseAPIInventarioPojo
  - `status` '100 CONTINUE' | '101 SWITCHING_PROTOCOLS' | '102 PROCESSING' | '103 EARLY_HINTS' | '103 CHECKPOINT' | '200 OK' | '201 CREATED' | '202 ACCEPTED' | '203 NON_AUTHORITATIVE_INFORMATION' | '204 NO_CONTENT' | '205 RESET_CONTENT' | '206 PARTIAL_CONTENT' | '207 MULTI_STATUS' | '208 ALREADY_REPORTED' | '226 IM_USED' | '300 MULTIPLE_CHOICES' | '301 MOVED_PERMANENTLY' | '302 FOUND' | '302 MOVED_TEMPORARILY' | '303 SEE_OTHER' | '304 NOT_MODIFIED' | '305 USE_PROXY' | '307 TEMPORARY_REDIRECT' | '308 PERMANENT_REDIRECT' | '400 BAD_REQUEST' | '401 UNAUTHORIZED' | '402 PAYMENT_REQUIRED' | '403 FORBIDDEN' | '404 NOT_FOUND' | '405 METHOD_NOT_ALLOWED' | '406 NOT_ACCEPTABLE' | '407 PROXY_AUTHENTICATION_REQUIRED' | '408 REQUEST_TIMEOUT' | '409 CONFLICT' | '410 GONE' | '411 LENGTH_REQUIRED' | '412 PRECONDITION_FAILED' | '413 PAYLOAD_TOO_LARGE' | '413 REQUEST_ENTITY_TOO_LARGE' | '414 URI_TOO_LONG' | '414 REQUEST_URI_TOO_LONG' | '415 UNSUPPORTED_MEDIA_TYPE' | '416 REQUESTED_RANGE_NOT_SATISFIABLE' | '417 EXPECTATION_FAILED' | '418 I_AM_A_TEAPOT' | '419 INSUFFICIENT_SPACE_ON_RESOURCE' | '420 METHOD_FAILURE' | '421 DESTINATION_LOCKED' | '422 UNPROCESSABLE_ENTITY' | '423 LOCKED' | '424 FAILED_DEPENDENCY' | '425 TOO_EARLY' | '426 UPGRADE_REQUIRED' | '428 PRECONDITION_REQUIRED' | '429 TOO_MANY_REQUESTS' | '431 REQUEST_HEADER_FIELDS_TOO_LARGE' | '451 UNAVAILABLE_FOR_LEGAL_REASONS' | '500 INTERNAL_SERVER_ERROR' | '501 NOT_IMPLEMENTED' | '502 BAD_GATEWAY' | '503 SERVICE_UNAVAILABLE' | '504 GATEWAY_TIMEOUT' | '505 HTTP_VERSION_NOT_SUPPORTED' | '506 VARIANT_ALSO_NEGOTIATES' | '507 INSUFFICIENT_STORAGE' | '508 LOOP_DETECTED' | '509 BANDWIDTH_LIMIT_EXCEEDED' | '510 NOT_EXTENDED' | '511 NETWORK_AUTHENTICATION_REQUIRED'
  - `userMessage` string
  - `developerMessage` object
  - `errorCode` string
  - `moreInfo` string
  - `data` InventarioPojo
    - `id` integer
    - `codigo` string
    - `codigoInternacional` string
    - `descripcion` string
    - `unidadMedida` UnidadMedidaPojo
      - `id` integer
      - `nombre` string
      - `codigo` string
      - `senDeSistema` boolean
      - `unidadMedidaTipo` UnidadMedidaTipoPojo
        - `id` integer
        - `nombre` string
      - `unidadMedidaAdministradorImpuestos` UnidadMedidaAdministradorImpuestosPojo
        - `id` integer
        - `codigo` string
        - `descripcion` string
      - `unidadMedidaBaseId` integer
      - `factor` number
    - `senActivo` boolean
    - `inventarioClasificacion` InventarioClasificacionPojo
      - `id` integer
      - `nombre` string
      - `senAfectaCostoPromedio` boolean
      - `senDeSistema` boolean
      - `codigo` string
    - `centroCosto` CentroCostoPojo
      - `id` integer
      - `nombre` string
      - `codigo` string
    - `contabilizacion` ContabilizacionPojo
      - `id` integer
      - `nombre` string
      - `codigo` string
      - `senDeSistema` boolean
    - `senFacturarSinExistencias` boolean
    - `senManejaSeriales` boolean
    - `perteneceAUnProducto` boolean
    - `utilidadEstimada` number
    - `impuestos` InventarioImpuestoPojo[]
      - `id` integer
      - `valor` number
      - `senSumaAlCosto` boolean
      - `idProceso` integer
      - `impuesto` ImpuestoPojo
        - `id` integer
        - `tipo` 'IVA' | 'ICA' | 'IMPOCONSUMONACIONAL' | 'IMPOCONSUMODISTRITAL' | 'IMPOCONSUMOADVALOREM' | 'IMPOCONSUMOADVALOREM_PCJ' | 'IMPOCONSUMOBOLSAS' | 'IMPUESTONACIONALALAGASOLINAYACPM' | 'RETEFUENTE' | 'RETEIVA' | 'RETEICA' | 'AUTORRETENCIONRENTA' | 'IMPOBEBIDASAZUCARADAS' | 'IMPOCOMESTIBLESULTRAPROCESADOS' | 'CUOTADEFOMENTOHORTIFRUTICOLA'
        - `nombre` string
        - `tipoCobro` 'PORCENTAJE' | 'VALOR'
        - `tarifa` number
        - `empresas` integer[]
      - `empresas` EmpresaPojo[]
        - `id` integer
        - `nombre` string
        - `prefijo` string
        - `identificacion` string
        - `digitoVerificacion` integer
        - `digitoVerificacionGenerado` boolean
        - `senPrincipal` boolean
        - `numeroEstablecimientos` integer
        - `tercero` TerceroPojo
          - `id` integer
          - `terceroTipoIdentificacion` TerceroTipoIdentificacionPojo
            - `id` integer
            - `abreviatura` string
            - `nombre` string
            - `codigo` string
            - `senEsEmpresa` boolean
            - `senManejaDV` boolean
          - `identificacion` string
          - `digitoVerificacion` integer
          - `digitoVerificacionGenerado` boolean
          - `primerNombre` string
          - `segundoNombre` string
          - `primerApellido` string
          - `segundoApellido` string
          - `nombreCompleto` string
          - `nombreCompletoEmpleado` string
          - `ciudad` UbicacionCiudadPojo
            - `id` integer
            - `ciudadNombre` string
            - `nombre` string
            - `codigo` string
            - `senSistema` boolean
            - `ubicacionDepartamento` UbicacionDepartamentoPojo
              - …
          - `codigo` string
          - `senActivo` boolean
          - `senManejaNomina` boolean
          - `atributos` boolean
          - `tarifaICA` number
          - `aplicaICAVentas` boolean
          - `terceroTipos` TerceroTipoPojo[]
            - `id` integer
            - `codigo` string
            - `nombre` string
          - `tieneDirPrincipal` boolean
          - `direccionPrincipal` DireccionPojo
            - `id` integer
            - `direccion` string
            - `ciudad` string
            - `telefonoPrincipal` string
            - `emailPrincipal` string
            - `sucursal` string
            - `senPrincipal` boolean
            - `terceroTipoDireccionId` integer
            - `ciudadId` integer
            - `terceroTipoTelefonoId` integer
            - `numeroTelefonoPrincipal` string
        - `ubicacionCiudad` UbicacionCiudadPojo
          - `id` integer
          - `ciudadNombre` string
          - `nombre` string
          - `codigo` string
          - `senSistema` boolean
          - `ubicacionDepartamento` UbicacionDepartamentoPojo
            - `id` integer
            - `nombre` string
            - `codigo` string
            - `senSistema` boolean
            - `ubicacionPais` UbicacionPaisPojo
              - …
        - `infoTributariaAdicional` string
        - `responsabilidadFiscal` TerceroResponsabilidadFiscalPojo[]
          - `id` integer
          - `codigo` string
          - `significado` string
        - `tieneLogo` boolean
      - `inventarioTipoImpuestoVenta` InventarioTipoImpuestoVentaPojo
        - `id` integer
        - `nombre` string
        - `tipo` 'GRAVADO' | 'EXENTO' | 'EXCLUIDO' | 'NO_GRAVADO' | 'AUI_GRAVADO'
        - `ubicacionPais` UbicacionPaisPojo
          - `id` integer
          - `nombre` string
          - `codigo` string
          - `codAlterno` string
      - `muestraAlerta` boolean
    - `atributos` boolean
    - `senManejaLotes` boolean
    - `senFavorito` boolean
    - `senNoModificable` boolean
    - `senManejaTallaColor` boolean
    - `senVerEnPos` boolean
    - `fechaInicioTallaColor` string
    - `fechaInicioSeriales` string
    - `fechaInicioLotes` string
    - `grupo` InventarioGrupoPojo[]
      - `id` integer
      - `codigo` string
      - `nombreGrupo` string
      - `folder` boolean
      - `seleccionado` boolean
      - `senActivo` boolean
      - `padre` InventarioGrupoPojo — recursive
      - `cantidadHijos` integer
      - `borrador` boolean
    - `fechaInicioPerteneceAUnProducto` string

## Other responses

- `400` — Bad Request
- `403` — No se han asignados permisos para consultar este servicio
- `409` — Conflict
- `500` — Error interno del servidor

---

[API](https://skmtc.dev/worldoffice/apis/world-office-api.md) · [All operations](https://skmtc.dev/worldoffice/apis/world-office-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/worldoffice/world-office-api/revisions/ab962606cb0a/schema)
