Importación automatizada de las declaraciones 10-Q y 10-K en formato XBRL desde SEC.gov

Question

Quiero leer automáticamente los estados financieros en formato XBRL del sitio de la SEC.

Por ejemplo, el archivo 10-Q de Apple: http://www.sec.gov/Archives/edgar/data/320193/000119312515259935/aapl-20150627.xml

Para la conversión de los datos XBRL quiero utilizar el paquete R XBRL.

Preguntas:

1. ¿Están estandarizados los nombres de los documentos y su dirección web en la SEC, de modo que pueda descargar los archivos automáticamente en un trabajo? ¿O tengo que seguir buscando la dirección web en el índice completo (véase Captura automatizada de datos 10-K XBRL utilizando la estructura de archivos de la SEC )?

2. ¿Está la etiqueta XBRL junto con los requisitos de la 10-Q /10-K de tal manera estandarizada, que puedo esperar etiquetas estandarizadas? Especialmente que NO la primera empresa etiquete "Coste de los bienes vendidos", la siguiente empresa "COGS" y la tercera empresa "Coste de los ingresos".

3. ¿El período de tiempo de los archivos 10-Q está estandarizado en 3 meses?

4. ¿Qué proporción de los 10-Q y 10-K son archivos disponibles en formato XBRL (porcentaje aproximado)?

5. ¿Hay algo parecido a una definición de XBRL disponible en algún lugar? Al aplicar

inst <- " http://www.sec.gov/Archives/edgar/data/320193/000119312515259935/aapl-20150627.xml "

aapl_10q= xbrlDoAll(inst, verbose=TRUE)

str(aapl_10q)

¡parece que hay muchos datos enredados!

Jujo

Answer 1

1. No hay norma. Las empresas pueden nombrar los campos como quieran. Al menos parece que se tolera.

2. No conozco el XBRL, pero puede ser útil saber que en el html de los estados financieros, puede ver qué líneas se adhieren a los PCGA mirando el nombre del campo en la etiqueta de la celda de la tabla. Todos ellos comienzan con gaap como gaap_costOfGoodsSold . Pero esto solo es cierto para los informes posteriores a 2011 aproximadamente. Y, afortunadamente, la denominación GAAP parece ser consistente en todas las empresas.

Answer 2

En primer lugar, no es necesario leer o analizar los estados financieros en formato XBRL.

Existe el método getFundamentals(ticker) proporcionado por el paquete eodhistoricaldata-api ( https://www.npmjs.com/package/eodhistoricaldata-api ).

La biblioteca devuelve estados financieros trimestrales (y anuales) (cuentas de resultados, balances y estados de flujo de caja). Los datos están estandarizados y se proporcionan en formato JSON.

Por ejemplo:

"Highlights": {
    "MarketCapitalization": 54915055616,
    "MarketCapitalizationMln": "54915.0556",
    "EBITDA": 616286976,
    "PERatio": null,
    "PEGRatio": "-1.5700",
    "WallStreetTargetPrice": "321.8900",
    "BookValue": "26.2790",
    "DividendShare": null,
    "DividendYield": null,
    "EarningsShare": "-4.8500",
    "EPSEstimateCurrentYear": "-6.5600",
    "EPSEstimateNextYear": "-2.0000",
    "EPSEstimateNextQuarter": "-1.6700",
    "MostRecentQuarter": "2018-09-30",
    "ProfitMargin": "-0.1022",
    "OperatingMarginTTM": "-0.0710",
    "ReturnOnAssetsTTM": "-0.0271",
    "ReturnOnEquityTTM": "-0.3397",
    "RevenueTTM": "17523644416.00",
    "RevenuePerShareTTM": "103.3240",
    "QuarterlyRevenueGrowthYOY": "1.2860",
    "GrossProfitTTM": "2222487000.00",
    "DilutedEpsTTM": "-10.5600",
    "QuarterlyEarningsGrowthYOY": null
},
// ...
"Income_Statement": {
        "currency_symbol": "USD",
        "quarterly": {
            "2018-09-30": {
                "date": "2018-09-30",
                "filing_date": "2018-11-02",
                "researchDevelopment": "350848000.00",
                "effectOfAccountingCharges": null,
                "incomeBeforeTax": "271320000.00",
                "minorityInterest": "1344731000.00",
                "netIncome": "311516000.00",
                "sellingGeneralAdministrative": "729876000.00",
                "grossProfit": "1523665000.00",
                "ebit": "442941000.00",
                "operatingIncome": "442941000.00",
                "otherOperatingExpenses": null,
                "interestExpense": "-169858000.00",
                "extraordinaryItems": null,
                "nonRecurring": null,
                "otherItems": null,
                "incomeTaxExpense": "16647000.00",
                "totalRevenue": "6824413000.00",
                "totalOperatingExpenses": "6381472000.00",
                "costOfRevenue": "5300748000.00",
                "totalOtherIncomeExpenseNet": "-171621000.00",
                "discontinuedOperations": null,
                "netIncomeFromContinuingOps": "254673000.00",
                "netIncomeApplicableToCommonShares": "311516000.00"
            },
            // ...
"Balance_Sheet": {
        "currency_symbol": "USD",
        "quarterly": {
            "2018-09-30": {
                "date": "2018-09-30",
                "filing_date": "2018-11-02",
                "intangibleAssets": "291476000.00",
                "totalLiab": "23409144000.00",
                "totalStockholderEquity": "4508838000.00",
                "deferredLongTermLiab": "0.00",
                "otherCurrentLiab": "2266778000.00",
                "totalAssets": "29262713000.00",
                "commonStock": "171000.00",
                "otherCurrentAssets": "158627000.00",
                "retainedEarnings": "-5457315000.00",
                "otherLiab": "2285172000.00",
                "goodWill": "65226000.00",
                "otherAssets": "1233979000.00",
                "cash": "2967504000.00",
                "totalCurrentLiabilities": "9775324000.00",
                "shortLongTermDebt": "2106538000.00",
                "otherStockholderEquity": "8271000.00",
                "propertyPlantEquipment": "19733969000.00",
                "totalCurrentAssets": "7920491000.00",
                "longTermInvestments": "17572000.00",
                "netTangibleAssets": "4152136000.00",
                "shortTermInvestments": "0.00",
                "netReceivables": "1155001000.00",
                "longTermDebt": "9726589000.00",
                "inventory": "3314127000.00",
                "accountsPayable": "3596984000.00",
                "totalPermanentEquity": "0.00",
                "noncontrollingInterestInConsolidatedEntity": "0.00",
                "temporaryEquityRedeemableNoncontrollingInterests": "0.00",
                "accumulatedOtherComprehensiveIncome": "0.00",
                "additionalPaidInCapital": "0.00",
                "commonStockTotalEquity": "0.00",
                "preferredStockTotalEquity": "0.00",
                "retainedEarningsTotalEquity": "0.00",
                "treasuryStock": "0.00"
            },
            // ...
"Cash_Flow": {
        "currency_symbol": "USD",
        "quarterly": {
            "2018-09-30": {
                "date": "2018-09-30",
                "filing_date": "2018-11-02",
                "investments": null,
                "changeToLiabilities": "895197000.00",
                "totalCashflowsFromInvestingActivities": "-560965000.00",
                "netBorrowings": "-221931000.00",
                "totalCashFromFinancingActivities": "-84218000.00",
                "changeToOperatingActivities": "98770000.00",
                "netIncome": "311516000.00",
                "changeInCash": "739728000.00",
                "totalCashFromOperatingActivities": "1391281000.00",
                "depreciation": "502825000.00",
                "otherCashflowsFromInvestingActivities": "128600000.00",
                "dividendsPaid": "0.00",
                "changeToInventory": "-55055000.00",
                "changeToAccountReceivables": "-587594000.00",
                "salePurchaseOfStock": "0.00",
                "otherCashflowsFromFinancingActivities": "42839000.00",
                "changeToNetincome": "179168000.00",
                "capitalExpenditures": "-559765000.00"
            },

El paquete es compatible con JavaScript del lado del cliente (React, React Native, Angular, Vue, etc.) y del lado del servidor (Node.js, etc.).