--- title: "Crear documento de salida de almacén" method: POST path: "/api/v1/inventarios/crearSalidaAlmacen" tags: ["Inventario"] --- # Crear documento de salida de almacén `POST /api/v1/inventarios/crearSalidaAlmacen` ## Request - Base URL: `https://api.worldoffice.cloud` - URL: `https://api.worldoffice.cloud/api/v1/inventarios/crearSalidaAlmacen` - Auth: none declared

Registra un documento salida de almacén con los siguientes campo:

https://api.worldoffice.cloud/api/v1/inventarios/crearSalidaAlmacen
fecha -> Fecha del documento formato YYYY-MM-DD,
prefijo -> ID del prefijo que se puede consultar del servicio listarPrefijoDocumento,
concepto -> Concepto del documento,
documentoTipo -> Codigó de documento que se ingresa (SA -> Salida de almacen),
idEmpresa -> ID empresa registrada,
idTerceroExterno -> ID tercero registrado,
idTerceroInterno -> ID tercero registrado,
idFormaPago -> ID forma de pago registrado,
idMoneda -> ID moneda registrada,
idDocumentoMotivosGeneracion -> Para los documentos de Notas id motivo generación,
idClasificacion -> Para los documentos de Notas id clasificación registrada,
porcentajeDescuento -> Campo booleano Verdadero Si el descuento es calculado por un porcentaje,
porcentajeTodosRenglones -> Campo booleano Verdadero Si el descuento aplica para todos los detalles,
valDescuento -> Valor que se descuenta a los detalles ingresado,
renglones -> Arreglo de los detalles de la factura que se van a registrar,
idInventario -> ID inventario registrado del detalle,
unidadMedida -> Codigo de unidad de medida,
cantidad -> Cantidad del deatlle,
valorUnitario -> Valor unitario del detalle,
valorTotal -> Valor total de detalle,
idBodega -> ID bodega del detalle,
idCentroCosto -> ID centro de costro,
concepto -> Concepto de detalle ,
porDescuento -> porcentaje de descuento del detalle si aplica,
idFactura -> En caso de que se desee cruzar el documento debe ingresar el ID (Opcional), aplica para documentos tipo NOTA
idDetalles -> Si desea ingresar detalles del documento cruzado, ingrese los ID's de los detalles que se pueden consultar en el servicio 'Consultar productos de documento de venta'(Opcional),

Petición de servicio:
{
  fecha: Date,
  prefijo: integer,
  documentoTipo: String,
  idEmpresa: integer,
  idTerceroExterno: integer,
  idTerceroInterno: integer,
  idFormaPago: integer,
  idMoneda: integer,
  trm: integer,
  porcentajeDescuento: boolean,
  porcentajeTodosRenglones: boolean,
  valDescuento: integer,
  reglones: [
    {
      idInventario: number,
      unidadMedida: String,
      cantidad: number,
      valorUnitario: number,
      idBodega: integer,
      porDescuento: number,
      concepto: String
    }
  ],
  idFactura: integer,
  idDetalles: [integer]
}

Respuesta en el data de la petición:
data: {
  id: integer,
  fecha: string,
  numero: integer,
  prefijo: {
    id: integer,
    nombre: string,
    descripcion: string
  },
  documentoTipo: {
    id: integer,
    codigoDocumento: string,
    nombreDocumento: string
  },
  empresa: {
    id: integer,
    nombre: string,
    prefijo: string,
    identificacion: string,
    digitoVerificacion: integer,
    digitoVerificacionGenerado: boolean,
    senPrincipal: boolean,
    numeroEstablecimientos: integer,
    tercero: {
      id: integer,
      terceroTipoIdentificacion: {
        id: integer,
        abreviatura: string,
        nombre: string,
        codigo: string,
        senEsEmpresa: boolean,
        senManejaDV: boolean,
        ubicacionPais: {
          id: integer,
          nombre: string,
          codigo: string,
          codAlterno: string
        }
      },
      identificacion: string,
      digitoVerificacion: integer,
      digitoVerificacionGenerado: boolean,
      primerNombre: string,
      segundoNombre: string,
      primerApellido: string,
      segundoApellido: string,
      nombreCompleto: string,
      ciudad: {
        id: integer,
        nombre: string,
        codigo: string,
        senSistema: boolean,
        ubicacionDepartamento: {
          id: integer,
          nombre: string,
          codigo: string,
          senSistema: boolean,
          ubicacionPais: {
            id: integer,
            nombre: string,
            codigo: string,
            codAlterno: string
          }
        }
      },
      codigo: string,
      senActivo: boolean,
      senManejaNomina: boolean,
      atributos: boolean,
      tarifaICA: integer,
      aplicaICAVentas: boolean,
      terceroTipos: [
        {
          id: integer,
          codigo: string,
          nombre: string
        }
      ]
    },
    ubicacionCiudad: {
      id: integer,
      nombre: string,
      codigo: string,
      senSistema: boolean,
      ubicacionDepartamento: {
        id: integer,
        nombre: string,
        codigo: string,
        senSistema: boolean,
        ubicacionPais: {
          id: integer,
          nombre: string,
          codigo: string,
          codAlterno: string
        }
      }
    },
    infoTributariaAdicional: string,
    responsabilidadFiscal: [
      {
        id: integer,
        codigo: string,
        significado: string
      }
    ]
  },
  terceroExterno: {
    id: integer,
    nombreCompleto: string,
    primerNombre: string,
    segundoNombre: string,
    primerApellido: string,
    segundoApellido: string,
    terceroTipoIdentificacion: string,
    identificacion: string,
    terceroTipoContribuyente: string,
    terceroClasificacionAdministradorImpuesto: string,
    terceroTipos: [
      {
        id: integer,
        codigo: string,
        nombre: string
      }
    ],
    senCupoCredito: boolean,
    terceroVendedorPredeterminado: {
      id: integer,
      nombreCompleto: string,
      primerNombre: string,
      segundoNombre: string,
      primerApellido: string,
      segundoApellido: string,
      terceroTipoIdentificacion: string,
      identificacion: string
    },
    formaPagoPredeterminada: {
      id: integer,
      codigo: string,
      nombre: string,
      senManejaCupoCredito: boolean
    },
    listaPrecioPredeterminada: {
      id: integer,
      nombre: string
    }
  },
  terceroInterno: {
    id: integer,
    nombreCompleto: string,
    primerNombre: string,
    segundoNombre: string,
    primerApellido: string,
    segundoApellido: string,
    terceroTipoIdentificacion: string,
    identificacion: string
  },
  direccionTerceroExterno: {
    id: integer,
    direccion: string,
    ciudad: string,
    telefonoPrincipal: string,
    sucursal: string,
    senPrincipal: boolean
  },
  formaPago: {
    id: integer,
    codigo: string,
    nombre: string,
    senManejaCupoCredito: boolean
  },
  moneda: {
    id: integer,
    codigo: string,
    nombre: string,
    separadorDecimales: string,
    separadorMiles: string,
    cantidadDecimales: integer,
    simbolo: string,
    tieneTRM: boolean
  },
  concepto: string,
  trm: integer,
  senContabilizado: boolean,
  documentoEncabezadosEstados: [
    {
      id: integer,
      codigo: String,
      nombre: string
    }
  ],
  numeroExterno: string,
  prefijoExterno: string,
  docAsociado: {
    id: integer,
    prefijo: {
      id: integer,
      nombre: string,
      descripcion: string
    },
    numero: integer,
    fecha: string,
    moneda: {
      id: integer,
      codigo: string,
      nombre: string,
      separadorDecimales: string,
      separadorMiles: string,
      cantidadDecimales: integer,
      simbolo: string,
      tieneTRM: boolean
    },
    documentoTipo: {
      id: integer,
      codigoDocumento: string,
      nombreDocumento: string
    },
    trm: integer,
    versionFe: integer,
    cufe: string
  },
  documentoMotivoGeneracion: {
    id: integer,
    codigo: string,
    motivo: string
  },
  documentoTipoNotaCredito: {
    id: integer,
    codigo: string,
    tipoNotaCredito: string,
    efectoEnInventario: integer
  },
  tieneRenglones: boolean,
  senGenerado: boolean,
  elaboradoPor: {
    id: integer,
    nombres: string
  },
  tieneResolucionElectronica: boolean,
  atributosRequeridos: boolean,
  atributosEncabezado: boolean,
  atributosRenglones: boolean,
  historialPrefijoPos: {
    numero: integer,
    nombrePrefijo: string
  }
}
## Request body - CrearDocumentoEncabezadoPojo: Datos de la compra - `id` integer - `numero` integer - `fecha` string, required - `prefijo` integer, required - `concepto` string - `documentoTipo` string, required - `idEmpresa` integer, required - `idTerceroExterno` integer, required - `idTerceroInterno` integer, required - `idFormaPago` integer, required - `idMoneda` integer, required - `idDocumentoMotivosGeneracion` integer - `trm` number - `numeroExterno` string - `prefijoExterno` string - `reglones` CrearDocumentoMovimientoInventarioPojo[], required - `id` integer - `idInventario` integer, required - `unidadMedida` string, required - `cantidad` number, required - `valorUnitario` number, required - `valorTotal` number - `idBodega` integer, required - `idCentroCosto` integer, required - `concepto` string - `porDescuento` number - `obsequio` boolean - `valorTotalRenglon` number - `idFactura` integer - `idDetalles` integer[] - `idClasificacion` integer - `porcentajeDescuento` boolean - `porcentajeTodosRenglones` boolean - `valDescuento` number ## Response `201` La consulta es realizada correctamente - ResponseAPIDocumentoEncabezadoPOJO - `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` DocumentoEncabezadoPOJO - `id` integer - `fecha` string, date-time - `numero` integer - `prefijo` PrefijoPojo - `id` integer - `nombre` string - `descripcion` string - `tipoResolucion` string - `senActivo` boolean - `documentoTipo` DocumentoTipoPojo - `id` integer - `codigoDocumento` string - `nombreDocumento` string - `empresa` 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 - `id` integer - `nombre` string - `codigo` string - `senSistema` boolean - `ubicacionPais` UbicacionPaisPojo - … - `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 - `id` integer - `nombre` string - `codigo` string - `codAlterno` string - `infoTributariaAdicional` string - `responsabilidadFiscal` TerceroResponsabilidadFiscalPojo[] - `id` integer - `codigo` string - `significado` string - `tieneLogo` boolean - `terceroExterno` TerceroExternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `terceroTipoContribuyente` string - `terceroClasificacionAdministradorImpuesto` string - `terceroTipos` TerceroTipoPojo[] - `id` integer - `codigo` string - `nombre` string - `senCupoCredito` boolean - `terceroVendedorPredeterminado` TerceroInternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `formaPagoPredeterminada` FormaPagoPojo - `id` integer - `codigo` string - `nombre` string - `senManejaCupoCredito` boolean - `idGrupo` integer - `nombreFormaPago` string - `idTerceroTipoConttribuyente` integer - `listaPrecioPredeterminada` ListaPrecioPojo - `id` integer - `nombre` string - `terceroInterno` TerceroInternoPojo - `id` integer - `nombreCompleto` string - `primerNombre` string - `segundoNombre` string - `primerApellido` string - `segundoApellido` string - `terceroTipoIdentificacion` string - `identificacion` string - `direccionTerceroExterno` DireccionPojo - `id` integer - `direccion` string - `ciudad` string - `telefonoPrincipal` string - `emailPrincipal` string - `sucursal` string - `senPrincipal` boolean - `terceroTipoDireccionId` integer - `ciudadId` integer - `terceroTipoTelefonoId` integer - `numeroTelefonoPrincipal` string - `formaPago` FormaPagoPojo - `id` integer - `codigo` string - `nombre` string - `senManejaCupoCredito` boolean - `idGrupo` integer - `nombreFormaPago` string - `moneda` MonedaPojo - `id` integer - `codigo` string - `nombre` string - `separadorDecimales` string - `separadorMiles` string - `cantidadDecimales` integer - `simbolo` string - `tieneTRM` boolean - `concepto` string - `trm` number - `senContabilizado` boolean - `documentoEncabezadosEstados` DocumentoEncabezadoEstadoPojo[] - `id` integer - `codigo` 'BLOQUEADO' | 'ANULADO' | 'VERIFICADO' | 'EXPORTADO' | 'PRESENTADO_ELECTRONICAMENTE' | 'AJUSTADO_AL_INVENTARIO' | 'EN_PROCESO_DE_CONTABILIZAR' | 'TRASLADO_INVENTARIO' - `nombre` string - `numeroExterno` string - `prefijoExterno` string - `docAsociado` DocumentoAsociadoPojo - `id` integer - `prefijo` PrefijoPojo - `id` integer - `nombre` string - `descripcion` string - `tipoResolucion` string - `senActivo` boolean - `numero` integer - `fecha` string, date-time - `moneda` MonedaPojo - `id` integer - `codigo` string - `nombre` string - `separadorDecimales` string - `separadorMiles` string - `cantidadDecimales` integer - `simbolo` string - `tieneTRM` boolean - `documentoTipo` DocumentoTipoPojo - `id` integer - `codigoDocumento` string - `nombreDocumento` string - `trm` number - `versionFe` integer - `cufe` string - `fechaInicioFacturacion` string, date-time - `fechaFinFacturacion` string, date-time - `documentoMotivoGeneracion` DocumentoMotivoGeneracionPojo - `id` integer - `codigo` string - `motivo` string - `documentoTipoNotaCredito` DocumentoTipoNotaCredito - `id` integer - `codigo` string - `tipoNotaCredito` string - `efectoEnInventario` integer - `tieneRenglones` boolean - `senGenerado` boolean - `senLiquidacion` boolean - `elaboradoPor` UsuarioPojo - `id` integer - `nombres` string - `activo` boolean - `email` string - `canal` string - `imagen` string - `usuarioTokens` UsuarioTokens[] - `id` integer - `jwt` string - `fechaRegistro` string, date-time - `fechaVencimiento` string, date-time - `sesTokenActivo` boolean - `tieneResolucionElectronica` boolean - `atributosRequeridos` boolean - `atributosEncabezado` boolean - `atributosRenglones` boolean - `senExisteDocumentoAsociado` boolean - `senSectorTransporte` boolean - `salidaAlmacenAsociada` integer - `tieneSalidaAlmacenAsociada` boolean - `tieneProductosConFichaTecnica` boolean ## Other responses - `400`: No se puede crear este documento - `403`: No se puede crear este documento - `409`: Conflict - `500`: Error interno del servidor ## Changes > 5 revisions in range; 1 not diffed. - **2026-09-18** `0f29d049f5e4`: 1 info - added the new optional request property `numero` [Operation history](https://skmtc.dev/worldoffice/apis/world-office-api/changes/api/v1/inventarios/crearSalidaAlmacen/post.md) --- [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.dev/worldoffice/apis/world-office-api/revisions/c407287d785f?raw)